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

Get Contacts

< Alle Themen
Returns a page of contacts in the accounts.

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

 

Attributes

ParameterDefaultDescription
standard_fieldMultivalued 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_fieldMultivalued 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_categoriesMultivalued parameter to query the preference values of a contact preference category. If nothing is specified the returned tag <preferences> will be ommitted.
page_indexThe index of the result page. The index must be greater or equal to 1.
page_size100The maximum count of items in the result page. If provided, the value of page_size must be in the range 1 to 1000.
updated_afterIf set, the call returns contacts only, which were updated after the given datetime. The format must be in SQL format: Y-m-d H:i:s.

 

Example

GET https://api.maileon.com/1.0/contacts?page_index=4&amp;page_size=5
Authorization: Basic XXXXXXXXXXXXXXXXXXXX
Accept: application/vnd.maileon.api+xml; charset=utf-8

Status: 200 OK
Link: ...
Content-Type: application/vnd.maileon.api+xml
X-Pages: ...
X-Items: ...

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

<contacts>
  <contact>
    <id>13629786</id>
    <permission>5</permission>
    <email>max.musermann@xqueue.com</email>
    <external_id nil="true"></external_id>
    <created>2016-06-13 09:14:41.0</created>
    <updated>2017-10-30 13:20:08.0</updated>
    <standard_fields></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>
    <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-19T15:30:53+0200</last_modified>
      </preference>
      <preference>
        <name>Magento</name>
        <category>Developer</category>
        <value>false</value>
        <source nil="true"/>
        <last_modified>2021-08-19T15:30:53+0200</last_modified>
      </preference>
    </preferences>
  </contact>
</contacts>
Inhaltsverzeichnis

Bleiben Sie Up-to-Date und profitieren Sie von spannenden News und Aktionen.

Maileon ist ein Produkt der XQueue GmbH