Update Contact By External ID

Updates an existing contact identified by their External ID.

PUT https://api.maileon.com/1.0/contacts/externalid/:external_id

Header

Payload

Example

PUT https://api.maileon.com/1.0/contacts/externalid/foo-1234
Authorization: Basic XXXXXXXXXXXXXXX
Content-Type: application/vnd.maileon.api+xml; charset=utf-8

<contact>
  <standard_fields>
    <field>
      <name>LASTNAME</name>
      <value>Mustermann</value>
    </field>
    <field>
      <name>FIRSTNAME</name>
      <value>Max</value>
    </field>
  </standard_fields>
  <custom_fields>
    <field>
      <name>COLOR</name>
      <value>BLUE</value>
    </field>
  </custom_fields>
</contact>

201 Created

PUT https://api.maileon.com/1.0/contacts/externalid/foo-1234
Authorization: Basic XXXXXXXXXXXXXXX
Content-Type: application/vnd.maileon.api+json; charset=utf-8

{
  "standard_fields": {
    "LASTNAME": "Mustermann",
    "FIRSTNAME": "Max"
  },
  "custom_fields": {
    "COLOR": "BLUE"
  }
}

201 Created

Preferences

Preferences are not yet supported in the JSON payload. In XML it is structured as follows:

<contact>
  ...
  <preferences>
    <preference>
      <name>MY_PREFERENCE_A</name>
      <category>MY_CATEGORY</category>
      <value>true</value>
      <source nil="true"/>
    </preference>
    <preference>
      <name>MY_PREFERENCE_B</name>
      <category>MY_CATEGORY</category>
      <value>true</value>
      <source nil="true"/>
    </preference>
  </preferences>
</contact>

Responses