Benötigen Sie Hilfe?
-
Maileon Anleitungen
-
-
- Bald verfügbar
-
- Bald verfügbar
-
-
-
-
- Bald verfügbar
-
- Bald verfügbar
-
- Bald verfügbar
-
-
-
- Bald verfügbar
-
- Bald verfügbar
-
- Bald verfügbar
-
-
-
-
- Bald verfügbar
-
-
-
FAQs
-
-
- Ich kann mir meine Export-Datei nicht wie gewünscht darstellen lassen. Was kann ich dagegen tun?
- Ich will Kontakte über die Schnittstelle hinzufügen aber der Kontakt taucht nicht in Maileon auf.
- Kann man gelöschte Abmelder wiederherstellen?
- Was ist eine „Permission“ und welche Permissionsarten gibt es?
- Wie kann ich Kontakt nach erfolgter Abmeldung wieder dem Kundenbestand hinzufügen?
- Wie lange darf ein Anbieter darauf warten, bis der Newsletter-Interessent seine eingetragene E-Mail-Adresse per Link-Klick bestätigt (Double Opt-In)?
- Wie lange dürfen unbestätigte Newsletter-Anmelder in meinem Kontaktbestand gespeichert werden?
- Wie werden Kundendaten in Maileon gesichert/ verschlüsselt?
- Wieso werden mir nicht alle Abmelder meines Kontos angezeigt?
- Wo kann ich die Abmelder meiner Newsletter einsehen?
- Wo kann ich einstellen, wie lange ich Abmelder sehe?
- Wo kann ich weitere Benutzer anlegen?
-
- Ich finde es mühsam feste Elemente, wie das Impressum, im Template immer in allen Mailings einzeln anzupassen. Gibt es eine bessere Möglichkeit?
- Kann ich auch eigene Schriftarten verwenden?
- Kann ich einen Countdown in meinen Newsletter einbauen?
- Warum zeigt mein Reporting bei Öffner und Klicker fast identische Zahlen an?
- Wie hinterlege ich einen Ref-Code?
-
- Kann man Absender/Antwort E-Mails schon vorher anlegen und diese immer verwenden?
- Kann man beim Versand aus den ausgewählten Verteilern noch manuell Personen für diesen Versand ausschließen?
- Kann man einen geplanten Versand noch einmal bearbeiten?
- Was ist das Einzelnutzer-Tracking und welche Tracking-Methoden gibt es?
- Was ist der Unterschied zwischen Absender-Alias und Empfänger-Alias?
- Was ist die Werbedruckkontrolle und wo kann ich diese anpassen?
- Wie verwende ich BIMI in meinen E-Mailings?
- Wieso ist meine 1. Welle in der Versandstreckung immer die Größte?
- Wo erscheint der Vorschautext?
-
-
- Bietet Maileon Rabatt für Non Profit Organisationen?
- Gibt es Ansprechpartner für Vertriebsfragen?
- Kann ich Maileon testen, bevor ich mich für das Tool entscheide?
- Muss ich direkt meine Zahlungsdaten hinterlegen?
- Was passiert, wenn ich die Limits meines Paketes überschreite?
- Welche Zahlungsmöglichkeiten werden angeboten?
- Wie gestaltet sich die Vertragslaufzeit?
- Wie hoch ist die Einrichtungsgebühr?
- Wie kann ich mein Maileon-Paket ändern?
-
- Bald verfügbar
-
-
Grundlagen
-
Für Entwickler
-
-
- Adding Unsubscription Reason to Already Unsubscribed Contact
- 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 Contact Preference
- Create Contact Preference Category
- Create Custom Field
- Custom Contact Fields
- Delete All Contacts
- Delete Contact By Maileon ID
- Delete Contact Preference
- Delete Contact Preference Category
- Delete Contacts By Email
- Delete Contacts By External ID
- Delete Custom Field
- Delete Custom Field Values
- Delete Standard Field Values
- Delete Unsubscription-Marker
- Get Blocked Contacts
- Get Contact By Email
- Get Contact By Maileon ID
- Get Contact Preference
- Get Contact Preference Categories
- Get Contact Preference Category by Name
- Get Contacts
- Get Contacts By Email
- Get Contacts By External Id
- Get Contacts By Filter Id
- Get Count Contacts
- Get Custom Fields
- Get Preferences of Contact Preferences Category
- Get Unsubscription-Marker
- Rename Custom Field
- Set Unsubscription-Marker
- 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
- Update Contact Preference
- Update Contact Preference Category
- Alle Artikel anzeigen ( 34 ) Artikel zusammenklappen
-
- Add Mailing Blacklist to Mailing
- Copy Mailing
- Create Dispatching
- Create Mailing
- Delete Mailing
- Delete Mailing Blacklist from Mailing
- Delete Trigger
- Get CMS2 Mailing As Zip
- Get Dispatching
- Get limit on number of contacts
- Get Mailing Archive URL
- Get Mailing Blacklists for Mailing
- 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 Templates for CMS2
- 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 Mailing Domain
- 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 Single Emailaddress
- 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 Quality Check
- Mailing – Update Custom Mailing Property
- Mailing – Update Schedule
- Reset Contents to Template
- Save CMS2 Mailing to Media Library
- Set limit on number of contacts before sending mailing
- Set Preview Text
- Set Template
- Set Template for CMS2 Mailing
- Set The Reply-To Address
- Alle Artikel anzeigen ( 94 ) Artikel zusammenklappen
Update Contact By Maileon ID
Sie sind hier:
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 of contact with contact preferences
<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"/> </preference> <preference> <name>Magento</name> <category>Developer</category> <value>false</value> <source nil="true"/> </preference> </preferences> </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