-
-
-
- Bald verfügbar
-
- Bald verfügbar
-
-
-
-
-
- Bald verfügbar
-
- Adding Unsubscription Reason
- Contacts
- Count Active Contacts By Filter ID
- Count Contacts By Filter ID
- Create Contact
- Create Contact (JSON)
- Create Contact by External ID
- Create Contact by External ID (JSON)
- Create Custom Field
- Custom Contact Fields
- Delete All Contacts
- Delete Contact By Maileon ID
- Delete Contacts By Email
- Delete Contacts By External ID
- Delete Custom Field
- Delete Custom Field Values
- Delete Standard Field Values
- Get Blocked Contacts
- Get Contact By Email
- Get Contact By Maileon ID
- Get Contacts
- Get Contacts By Email
- Get Contacts By External Id
- Get Contacts By Filter Id
- Get Count Contacts
- Get Custom Fields
- Rename Custom Field
- Standard Contact Fields
- Synchronize Contacts
- Synchronize Contacts Error Codes
- Unsubscribe Contact By Maileon Id
- Unsubscribe Contacts By Email
- Unsubscribe Contacts by External Id
- Update Contact By Email
- Update Contact By External ID
- Update Contact By Maileon ID
- Alle Artikel anzeigen ( 21 ) Artikel zusammenklappen
-
- Copy Mailing
- Create Dispatching
- Create Mailing
- Delete Mailing
- Delete Trigger
- Get Dispatching
- Get limit on number of contacts
- Get Mailing Archive URL
- Get Mailing ID By Name
- Get Mailing Report URL
- Get Mailings By Creator Name
- Get Mailings By Keywords
- Get Mailings By Schedule Time
- Get Mailings By States
- Get Mailings By Subject
- Get Mailings By Types
- Get Preview Text
- Get Template
- Get The Reply-To Address
- Mailing – Add Attachment
- Mailing – Add Custom Mailing Properties
- Mailing – Copy Attachments
- Mailing – Create Schedule
- Mailing – Delete Attachment
- Mailing – Delete Attachments
- Mailing – Delete Schedule
- Mailing – Disable QoS Checks
- Mailing – Enable Target Group Update
- Mailing – Fill RSS SmartMailing Tags
- Mailing – Get “Ignore Permission” State
- Mailing – Get “Post Sendout Cleanup” State
- Mailing – Get Archival Duration
- Mailing – Get Attachment
- Mailing – Get Attachments
- Mailing – Get Count Attachments
- Mailing – Get DOI Mailing Key
- Mailing – Get HTML
- Mailing – Get List of Custom Mailing Properties
- Mailing – Get Locale
- Mailing – Get Max Attachment Size
- Mailing – Get Max Content Size
- Mailing – Get Name
- Mailing – Get Recipient Alias
- Mailing – Get result for Link Quality Check
- Mailing – Get result for Message Size Quality Check
- Mailing – Get result for Personalization Quality Check
- Mailing – Get result for Spam Quality Check
- Mailing – Get results for Approval Sendout Quality Check
- Mailing – Get results for Attention Quality Check
- Mailing – Get results for Bounce Quality Check
- Mailing – Get results for Display Quality Check
- Mailing – Get results for Image Quality Check
- Mailing – Get results for Test Mail Sendout
- Mailing – Get Schedule
- Mailing – Get Sender Address
- Mailing – Get Sender Alias
- Mailing – Get Speed Level
- Mailing – Get State
- Mailing – Get Subject
- Mailing – Get Tags
- Mailing – Get Target Group Id
- Mailing – Get Target Group Update status
- Mailing – Get Text
- Mailing – Get Tracking Duration
- Mailing – Get Tracking Strategy
- Mailing – Get Type
- Mailing – Is Sealed
- Mailing – Remove Custom Mailing Property
- Mailing – Send Approval Mail to Targetgroup
- Mailing – Send Now
- Mailing – Send Testmail to Targetgroup
- Mailing – Set “Ignore Permission” State
- Mailing – Set “Post Sendout Cleanup” State
- Mailing – Set DOI Mailing Key
- Mailing – Set Html
- Mailing – Set Locale
- Mailing – Set Name
- Mailing – Set Recipient Alias
- Mailing – Set Sender Address
- Mailing – Set Sender Alias
- Mailing – Set Speed Level
- Mailing – Set Subject
- Mailing – Set Tags
- Mailing – Set Target Group Id
- Mailing – Set Text
- Mailing – Set Tracking Strategy
- Mailing – Start Attention Quality Check
- Mailing – Start Bounce Quality Check
- Mailing – Start Image Quality Check
- Mailing – Start Link Quality Check
- Mailing – Start Message Size Quality Check
- Mailing – Start Personalization Quality Check
- Mailing – Start Spam Quality Check
- Mailing – Update Custom Mailing Property
- Mailing – Update Schedule
- Merge Tags
- Reset Contents to Template
- Set limit on number of contacts before sending mailing
- Set Preview Text
- Set Template
- Set The Reply-To Address
- Alle Artikel anzeigen ( 86 ) Artikel zusammenklappen
-
- Bald verfügbar
-
- Bald verfügbar
-
- Bald verfügbar
Update Contact By Maileon ID
Sie sind hier:
- Inhaltsübersicht
- Für Entwickler
- Docs
- Rest API V1
- Contacts
- Update Contact By Maileon ID
< Alle Themen
Update a contact using the maileon contact id and the corresponding checksum. This call updates standard and custom contact fields as well as the external id of the contact (if provided). It is also possible to update the permission of the contact. In case the permission is upgraded to double opt-in or double opt-in plus, a doi process can be triggered by using the corresponding parameters (and the permission is not set directly).
PUT https://api.maileon.com/1.0/contacts/contact
Attributes
Parameter | Default | Description |
id | The maileon contact id | |
checksum | The checksum of the maileon contact id | |
permission | This parameter should only be used if the permission of the contact should be updated. Supported values are 1: none, 2: single opt-in, 3: confirmed opt-in, 4: double opt-in, 5: double opt-in plus, 6: other. Please be aware of the rules specified with parameter triggerdoi | |
triggerdoi | false | If provided and true (supported values are true and false) and if the permission is either 1, 2, 3 or 6 the permission will be set directly and NO DOI mail will be sent as it is not required for those permissions. If the permission is set to 4 (doi) or 5 (doi+), a doi process will be triggered for the contact instead of setting the permission to 4 or 5 instantly (again: the permission will not be changed). |
src | A string intended to describe the source of the contact. If provided, the string will be stored with the doi process | |
page_key | In case where this method was called by a landing page such as a profile update page, this string offers the possibility to keep track of it for use in reports related to doi processes | |
doimailing | This parameter is ignored if triggerdoi is not provided or false. References the doi mailing to be used. If not provided, the default doi mailing will be used | |
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
PUT https://api.maileon.com/1.0/contacts/contact?id=123&checksum=XgF91SjkC2 Authorization: Basic XXXXXXXXXXXXXXX Content-Type: application/vnd.maileon.api+xml; charset=utf-8 <?xml version="1.0" encoding="UTF-8"?> <contact> <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>
Example response if contact exists
<report> <success>false</success> <contact> <email>max.mustermann@xqueue.com</email> <external_id nil="true"></external_id> <error> <error_field>email</error_field> <error_message>duplicate email</error_message> </error> </contact> </report>
Inhaltsverzeichnis