Return a contact using the maileon contact id. This resource is intended to be used in profile update pages to prefill profile update forms. In order to prevent form fields manipulation, a checksum of the maileon contact id is required as parameter. Please refer to the documentation of the profile update pages for more details about how to get the maileon contact id and the corresponding checksum.
1 |
GET https://api.maileon.com/1.0/contacts/contact |
Attributes
ParameterDefaultDescription
id | The maileon contact id. | |
checksum | / | The checksum of the maileon contact id. |
standard_field | / | Multivalued parameter to query the value of a standard contact field. |
custom_field | Multivalued parameter to query the value of a custom contact field. | |
ignore_checksum | false | If this flag is set to true, the method will ignore the checksum. This flag should only be set when the call is not issued by a customer directly but by a third party application. See FAQ for further information. |
Example
GET https://api.maileon.com/1.0/contacts/contact?id=123&checksum=XgF91SjkC2&standard_field=FIRSTNAME&standard_field=LASTNAME&custom_field=COLOR Authorization: Basic XXXXXXXXXXXXXXX Accept: application/vnd.maileon.api+xml; charset=utf-8 Status: 200 OK Content-Type: application/vnd.maileon.api+xml <?xml version="1.0" encoding="UTF-8"?> <contact> <id>123</id> <!-- 1:none, 2:single opt-in, 3: confirmed opt-in, 4:double opt-in, 5: double opt-in plus, 6: other--> <permission>1</permission> <email>max.mustermann@xqueue.com</email> <external_id>dummy</external_id> <standard_fields> <field> <name>FIRSTNAME</name> <value>Max</value> </field> <field> <name>LASTNAME</name> <value nil="true"/> </field> </standard_fields> <custom_fields> <field> <name>COLOR</name> <value>BLUE</value> </field> </custom_fields> </contact>