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.

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>