-
-
-
- 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
Synchronize Contacts
Sie sind hier:
- Inhaltsübersicht
- Für Entwickler
- Docs
- Rest API V1
- Contacts
- Synchronize Contacts
< Alle Themen
Synchronizes (updates) the contacts in the account with the data from a list of contacts and returns a detailed report with stats and validation errors. This method is meant to update large sets of contacts while “Create Contact” and “Update Contact” are used to update single contatcs only. With this method, e.g. flags for contact filters can be updated to update the set of contacts that shall receive a certain mailing.
Duplicates (e.g. contacts with the same email address when the email address is the primary identificator) are nor allowed in one call and will be ignored as it is not defined which one should possibly override the other.
POST https://api.maileon.com/1.0/contacts
Attributes
Parameter | Default | Description |
permission | 1 | Specifies the permission to be assigned to the contact. Supported values are 1: none, 2: single opt-in, 3: confirmed opt-in, 4: double opt-in, 5: double opt-in plus, 6: other |
sync_mode | 2 | Specifies the synchronization option in case a contact with the provided identifier (external id or email address) already exists:1: update, 2: ignore |
use_external_id | false | If set to true, the external id is used as identifier for the contacts. Otherwise the email address is used as identifier. If ‘use_external_id’ and ‘prefer_maileon_id’ are set to true, a bad request (400) will be returned. |
prefer_maileon_id | false | If set to true, the maileon id is used as identifier for the contacts. If no id is set, the email will be used instead. If ‘prefer_maileon_id’ and ‘use_external_id’ are set to true, a bad request (400) will be returned. |
ignore_invalid_contacts | false | If set to true, invalid contacts are ignored and the synchronization succeeds for valid contacts. |
override_permission | true | If set to true the permission of existing and non existing contacts will be set to the given permission. If the permission is not set, permission ‘none’ will be set for new contacts and the permission of existing contacts will not be changed. If set to false, the permission will be used for new contacts only and the permission of existing contacts will not be changed. |
reimport_unsubscribed_contacts | true | If set to true unsubscribed contacts will be reimported, else, they will be ignored. |
update_only | false | If set to true only existing contacts will be updated. Not existing contacts will not be created. |
Example (Request)
POST https://api.maileon.com/1.0/contacts?permission=5&sync_mode=1 Authorization: Basic XXXXXXXXXXXXXXX Content-Type: application/vnd.maileon.api+xml; charset=utf-8 <contacts> <contact> <email>max.mustermann@xqueue.com</email> <external_id>external-id-1</external_id> <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> <contact> <email>erika.mustermann@xqueue.com</email> <external_id>external-id-2</external_id> <standard_fields> <field> <name>LASTNAME</name> <value>Mustermann</value> </field> <field> <name>FIRSTNAME</name> <value>Erika</value> </field> </standard_fields> <custom_fields> <field> <name>COLOR</name> <value>RED</value> </field> </custom_fields> </contact> </contacts>
Inhaltsverzeichnis