MAPI Manual

NAME

UPDATE_CONTACT_INCONTACTGROUP

FUNCTION

Update a contact within a contact group

SYNOPSIS

contact_id, contactgroup_id, data_format, contact_data, 1...N

DESCRIPTION

This function allows users to update a contact within a contact group.

Required Parameters

* action: UPDATE_CONTACT_INCONTACTGROUP.
* contact_id: ID of the contact.
* contactgroup_id: ID of the contact group.
* data_format: specifies how the contact data is represented. Value is either "record_type" or "url_type". Default is "record_type".

Optional Parameters

* contact_data: data for the new contact. If the data format is "record_type", the value of this parameter consists of Tab-separated values. The first value specifies the name of contact. The second one specifies the mobile number, and needs to be preceded with a '+' plus sign and country code, e.g., +61400000000. The last one specifies the email. If the data format is "url_type", the value of this parameter is made up of key-value pairs concatenated by "&" ampersand. The key is a number representing the contact column ID, and its value needs to be URL encoded. For example, "1=simon&2=%2B61400000000&3=simon%40example.com", within this value, "1" represents contact name, "2" represents mobile number and "3" represents email. Please note that the whole value of contact_data also needs to be URL encoded.
  Note: If the data format is "url_type", the key-value pairs of the contact columns can be directly added to the request and the contact_data parameter is not required.
* 1...N: specifies the values of the contact columns when data_format is "url_type".

RETURN DATA

The response contains the following attribute:
* msg: a string indicating the contact has been updated successfully.

ROLE PERMITTED

Manager

EXAMPLES

The following example shows a successful HTTP GET request and response.

Request:
http://app02.yvntech.com/MapIHttpS/MapIS?action=UPDATE_CONTACT_INCONTACTGROUP&contact_id=1155&contactgroup_id=164&data_format=record_type&contact_data=Steven%09%2B61422222223%09steven%40example.com&login_name=user@example.com&login_passwd=1111

Response:
<result tftype='1' infotype='0'>
    <field name='msg'>SUCCESS</field>
</result>

TIPS

ENVIRONMENT

AUTHOR

YVN Tech

SEE ALSO

ADD_CONTACT_TOCONTACTGROUP

Mweb v2.0 YVNTECH 2014