+49 69 83008980 service@xqueue.com

Benötigen Sie Hilfe?

Update Contact By Email

Sie sind hier:
< Alle Themen

 

Updates a contact. The body needs to provide a XML representation of the contact, in the easiest case an empty contact: <contact></contact>. If the email address is not unique, a 409 is returned.

The email should not be part of the body as it is passed as a URL (resource) element.
If you want to set an external ID make sure to never set the email address in the body. Valid expression: <contact><external_id>12345</external_id></contact>

PUT https://api.maileon.com/1.0/contacts/email/:email

 

Attributes

Parameter Default Description
permission 1 Specifies the initial permission to be assigned to the contact.Please note: this is the initial permission that is assigned to the contact as soon as it is created. If a double-opt-in process is triggered, the permission is changed to DOI or DOI+ after the contact used the acknowledgement link in the DOI mailing. If the same contact is registered again after already acknowledging the DOI link (and thus, already has Permission 4 or 5) and you call this method with any other permission then 4 or 5 (less valuable), the permission will be ignored, since you already own a valid DOI(+) permission.
Further, if Permission 4 or 5 is already set and the account is set up not to send DOI mailings if there is already a DOI permission, no DOI mailing is triggered when creating the contact a second time.Supported values:
1: none
2: single opt-in
3: confirmed opt-in
4: double opt-in
5: double opt-in plus
6: other

 

Example

Request

PUT https://api.maileon.com/1.0/contacts/email/max.mustermann%40xqueue.com?permission=1&amp;sync_mode=2&amp;doi=true&amp;doiplus=true
Authorization: Basic XXXXXXXXXXXXXXX
Content-Type: application/vnd.maileon.api+xml; charset=utf-8

&lt;contact&gt;
  &lt;email&gt;max.mustermann.neu@xqueue.com&lt;/email&gt;
  &lt;standard_fields&gt;
    &lt;field&gt;
      &lt;name&gt;LASTNAME&lt;/name&gt;
      &lt;value&gt;Mustermann&lt;/value&gt;
    &lt;/field&gt;
    &lt;field&gt;
      &lt;name&gt;FIRSTNAME&lt;/name&gt;
      &lt;value&gt;Max&lt;/value&gt;
    &lt;/field&gt;
  &lt;/standard_fields&gt;
  &lt;custom_fields&gt;
    &lt;field&gt;
      &lt;name&gt;COLOR&lt;/name&gt;
      &lt;value&gt;BLUE&lt;/value&gt;
    &lt;/field&gt;
  &lt;/custom_fields&gt;
&lt;/contact&gt;

 

Response

Status: 201 Created

 

Inhaltsverzeichnis