+49 69 83008980 service@xqueue.com
Benötigen Sie Hilfe?

Im Maileon Help-Center finden Sie umfassende Dokumentationen zu unserem System.

Beliebte Suchanfragen: Importe | Rest-API | Integrationen | SMS

Get Contacts By External Id

Sie sind hier:

Returns the contacts matching the provided external id value.

GET https://api.maileon.com/1.0/contacts/externalid/:value

Attributes

Parameter Default Description
standard_field Multivalued parameter to query the value of a standard contact field. If a standard field has no value, it will be returned with nil-type value: <value nil=„true“></value>.
custom_field Multivalued parameter to query the value of a custom contact field. If no custom fields are specified, tag <custom_fields/> is returned, if a custom field has no value it will be removed from the answer.
preference_categories Multivalued parameter to query the preference values of a contact preference category. If nothing is specified the returned tag <preferences> will be ommitted.

Example

GET https://api.maileon.com/1.0/contacts/externalid/foo?standard_field=FIRSTNAME&amp;standard_field=LASTNAME
Authorization: Basic XXXXXXXXXXXXXXXXXXXX
Accept: application/vnd.maileon.api+xml; charset=utf-8

Status: 200 OK

< ?xml version="1.0" encoding="UTF-8"?>

<contacts>
  <contact>
    <id>15975220</id>
    <email>max.mustermann@xqueue.com</email>
    <external_id>foo</external_id>
    <created>2016-06-13 09:14:41.0</created>
    <updated>2017-10-30 13:20:08.0</updated>
    <standard_fields>
      <field>
        <name>FIRSTNAME</name>
        <value>Max</value>
      </field>
      <field>
        <name>LASTNAME</name>
        <value>Mustermann</value>
      </field>
    </standard_fields>
    <custom_fields></custom_fields>
  </contact>
</contacts>

Example of contact with contact preferences

<contacts>
  <contact>
    <id>12345</id>
    <email>max.mustermann@xqueue.com</email>
    <external_id>mustermann-ext-1956</external_id>
    <created>2016-06-13 09:14:41.0</created>
    <updated>2021-10-30 13:20:08.0</updated>
    <standard_fields>
      <field>
        <name>FIRSTNAME</name>
        <value>Max</value>
      </field>
      <field>
        <name>LASTNAME</name>
        <value>Mustermann</value>
      </field>
    </standard_fields>
    <custom_fields/>
    <preferences>
      <preference>
        <name>Shopware</name>
        <category>Developer</category>
        <value>true</value>
        <source nil="true"/>
        <last_modified>2021-08-19 15:30:53</last_modified>
      </preference>
      <preference>
        <name>Magento</name>
        <category>Developer</category>
        <value>false</value>
        <source nil="true"/>
        <last_modified>2021-08-19 15:30:53</last_modified>
      </preference>
    </preferences>
  </contact>
</contacts>
Inhaltsverzeichnis