Relatie toevoegen
Voegt een relatie toe aan een lijst. Naast het e-mailadres is het IP-adres verplicht, want daarmee leg je vast waar de aanmelding vandaan komt. Eigen velden geef je mee in
Bestaat het adres al in de lijst, dan volgt een foutmelding, tenzij je
If the address already exists in the list, an error message is returned, unless you set
Existiert die Adresse bereits in der Liste, folgt eine Fehlermeldung, es sei denn, du setzt
Si la dirección ya existe en la lista, recibes un mensaje de error, salvo que pongas
custom_fields, met de custom_name van het veld als sleutel.Bestaat het adres al in de lijst, dan volgt een foutmelding, tenzij je
options[upsert] op true zet.
Adds a subscriber to a list. Besides the email address, the IP address is required, as this records where the signup came from. You pass custom fields in custom_fields, using the custom_name of the field as the key.If the address already exists in the list, an error message is returned, unless you set
options[upsert] to true.
Fügt einer Liste einen Abonnenten hinzu. Neben der E-Mail-Adresse ist die IP-Adresse Pflicht, denn damit hältst du fest, woher die Anmeldung kommt. Eigene Felder gibst du in custom_fields mit, mit dem custom_name des Feldes als Schlüssel.Existiert die Adresse bereits in der Liste, folgt eine Fehlermeldung, es sei denn, du setzt
options[upsert] auf true.
Añade un contacto a una lista. Además de la dirección de correo electrónico, la dirección IP es obligatoria, porque con ella registras de dónde procede el registro. Los campos adicionales los envías en custom_fields, con el custom_name del campo como clave.Si la dirección ya existe en la lista, recibes un mensaje de error, salvo que pongas
options[upsert] en true.Authentifizierung
AuthorizationBasic
Vul je API-sleutel in bij
api_key en laat leave_empty leeg. De API gebruikt basic auth, waarbij je sleutel de plaats van de gebruikersnaam inneemt. In curl schrijf je dat als -u JOUW_SLEUTEL:, met een dubbele punt en niets erachter.
Enter your API key at api_key and leave leave_empty empty. The API uses basic auth, with your key in place of the username. In curl that reads -u YOUR_KEY:, with a colon and nothing after it.
Trage deinen API-Schlüssel bei api_key ein und lass leave_empty leer. Die API nutzt Basic Auth, wobei dein Schlüssel an die Stelle des Benutzernamens tritt. In curl schreibst du das als -u DEIN_SCHLUESSEL:, mit einem Doppelpunkt und nichts dahinter.
Introduce tu clave API en api_key y deja leave_empty vacío. La API usa basic auth, con tu clave en lugar del nombre de usuario. En curl se escribe como -u TU_CLAVE:, con dos puntos y nada después.Anfrage
This endpoint expects an object.
list_id
Het id van de lijst. Dat vind je in het antwoord van Alle lijsten opvragen, en in de applicatie in de URL van de lijst.
The id of the list. You find it in the response of Get all lists, and in the application in the URL of the list.
Die ID der Liste. Du findest sie in der Antwort von Alle Listen abrufen und in der Anwendung in der URL der Liste.
El id de la lista. Lo encuentras en la respuesta de Obtener todas las listas y en la aplicación, en la URL de la lista.
ip
Het IP-adres waarvandaan de aanmelding kwam. Bij een formulier op je site is dat het adres van de bezoeker, niet dat van je server.
The IP address the sign-up came from. For a form on your site that is the visitor address, not your server address.
Die IP-Adresse, von der die Anmeldung kam. Bei einem Formular auf deiner Website ist das die Adresse des Besuchers, nicht die deines Servers.
La dirección IP desde la que llegó el registro. En un formulario de tu web es la dirección del visitante, no la de tu servidor.
email
Het e-mailadres van de toe te voegen relatie.
The email address of the subscriber to be added
Die E-Mail-Adresse des hinzuzufügenden Abonnenten.
La dirección de correo electrónico del contacto que se va a añadir.
source_url
De URL vanwaar de relatie is aangemeld.
The URL from which the subscriber is registered
Die URL, von der aus der Abonnent angemeldet wurde.
La URL desde la que se ha registrado el contacto.
custom_fields
De waardes van de extra aangemaakte velden. De naam (de key) van het veld moet de ‘custom_name’ zijn (onderdeel van het Field object). Dit is gelijk aan de ‘Relatievariabele’ in de applicatie. Labels geef je mee als reeks, met vierkante haken: custom_fields[labels][]=Klant. Zonder die haken slaagt de aanroep wel maar verandert er niets, en een label dat de lijst niet heeft geeft foutcode 203.
The values of the extra fields. The name (key) of the field is the ‘custom_name’ (part of the Field object). This is the same as the ‘Variable’ in the application. You pass labels as an array, with square brackets: custom_fields[labels][]=Customer. Without those brackets the call still succeeds but nothing changes, and a label that the list does not have returns error code 203.
Die Werte der zusätzlich angelegten Felder. Der Name (der key) des Feldes muss der ‘custom_name’ sein (Teil des Field-Objekts). Das entspricht der ‘Abonnentenvariable’ in der Anwendung. Labels werden als Array übergeben, mit eckigen Klammern: custom_fields[labels][]=Kunde. Ohne diese Klammern gelingt der Aufruf zwar, es ändert sich aber nichts, und ein Label, das die Liste nicht hat, liefert den Fehlercode 203.
Los valores de los campos adicionales creados. El nombre (la key) del campo debe ser el ‘custom_name’ (parte del objeto Field). Esto equivale a la ‘variable de contacto’ en la aplicación. Las etiquetas las pasas como array, con corchetes: custom_fields[labels][]=Cliente. Sin esos corchetes la llamada funciona pero no cambia nada, y una etiqueta que la lista no tiene devuelve el código de error 203.
options
Extra aanwijzingen, mogelijkheden zijn: upsert: true om velden te overschrijven als het e-mailadres al aan een actieve relatie van deze lijst gekoppeld is. Normaal gesproken zou je een foutmelding krijgen als het e-mailadres al gekoppeld is aan een actieve relatie. Let op: Als een relatie uitgeschreven is en je doet een upsert met dat e-mailadres, dan wordt deze weer op actief gezet. Indien je wilt voorkomen dat een uitgeschreven relatie weer actief wordt, kun je de optie suppress_reactivation gebruiken. suppress_reactivation: true om te voorkomen dat een uitgeschreven relatie weer op actief wordt gezet bij een upsert suppress_email_notification: true om te voorkomen dat bij elke aanmelding via een api een notificatiemailtje wordt verstuurd ignore_doubleoptin: true om relaties bij een double-optin lijst meteen actief te maken en ervoor te zorgen dat er geen bevestigingsmail wordt verstuurd bij een aanmelding via de api.
Additional instructions, with possibilities being: upsert: true to overwrite fields if the email address is already linked to an active contact in this list. Normally, you would receive an error if the email address is already linked to an active contact. Note: If a subscriber is unsubscribed and you perform an upsert with that email address, it will be set to active again. If you want to prevent an unsubscribed subscriber from being reactivated, you can use the suppress_reactivation option. suppress_reactivation: true to prevent an unsubscribed subscriber from being reactivated during an upsert suppress_email_notification: true to prevent a notification email from being sent every time someone logs in via an API ignore_doubleoptin: true to instantly activate subscribers on a double-optin list and ensure that no confirmation email is sent when signing up through the API.
Zusätzliche Anweisungen, mögliche Optionen sind: upsert: true, um Felder zu überschreiben, wenn die E-Mail-Adresse bereits mit einem aktiven Abonnenten dieser Liste verknüpft ist. Normalerweise würdest du eine Fehlermeldung bekommen, wenn die E-Mail-Adresse schon mit einem aktiven Abonnenten verknüpft ist. Achtung: Wenn ein Abonnent abgemeldet ist und du machst einen upsert mit dieser E-Mail-Adresse, wird er wieder auf aktiv gesetzt. Wenn du verhindern willst, dass ein abgemeldeter Abonnent wieder aktiv wird, kannst du die Option suppress_reactivation verwenden. suppress_reactivation: true, um zu verhindern, dass ein abgemeldeter Abonnent bei einem upsert wieder auf aktiv gesetzt wird suppress_email_notification: true, um zu verhindern, dass bei jeder Anmeldung über eine API eine Benachrichtigungsmail versendet wird ignore_doubleoptin: true, um Abonnenten bei einer Double-Optin-Liste sofort aktiv zu machen und dafür zu sorgen, dass bei einer Anmeldung über die API keine Bestätigungsmail versendet wird.
Instrucciones adicionales, las posibilidades son: upsert: true para sobrescribir campos si la dirección de correo electrónico ya está vinculada a un contacto activo de esta lista. Normalmente recibirías un mensaje de error si la dirección de correo electrónico ya está vinculada a un contacto activo. Ten en cuenta lo siguiente: si un contacto está dado de baja y haces un upsert con esa dirección de correo electrónico, se vuelve a poner como activo. Si quieres evitar que un contacto dado de baja vuelva a estar activo, puedes usar la opción suppress_reactivation. suppress_reactivation: true para evitar que un contacto dado de baja se vuelva a poner como activo en un upsert suppress_email_notification: true para evitar que se envíe un correo de notificación en cada registro a través de una api ignore_doubleoptin: true para activar de inmediato los contactos de una lista con double-optin y evitar que se envíe un correo de confirmación en un registro a través de la api.
Antwort
De aanvraag is gelukt.
The request succeeded.
Die Anfrage war erfolgreich.
La solicitud se ha realizado correctamente.
member
Het member-object
The member object
Das member-Objekt
El objeto member
Fehler
400
Bad Request Error
401
Unauthorized Error
429
Too Many Requests Error