logo   HOME

Email Contacts

This page lists the optional parameters, request data and reponse in xml

Retrieve all groups for a specific contact [HTTP GET]

https://appapi.dlangemobile.com/xml/emailcontacts/{api_key}/{contact_id}/groups

URL Parameters

  • api_key (Required) - Your API application key.
  • contact_id (Required) - ID of contact to get groups.

Response Notes

Returns a list of all groups assigned to the contact including the group ID. ColorCode is in 32-bit ARGB format.

Example XML Response

<EmailGroups>
  <EmailGroup>
    <ID>1</ID>
    <Name>Group 1</Name>
    <ColorCode>-256</ColorCode>
  </Group>
  <Group>
    <ID>2</ID>
    <Name>Group 2</Name>
    <ColorCode>-13434625</ColorCode>
  </EmailGroup>
</EmailGroups>

Error Codes

  • 001 - API key is required.
  • 002 - Invalid API key.
  • 101 - Define a valid Contact ID.
  • 102 - Invalid Contact ID format. Contact ID should be an integer.
  • 103 - Contact not found. Please provide a valid Group ID.