Hoe geef ik extra gegevens mee tijdens het versturen van content via REST API?

Introductie

Het is mogelijk om tijdens het verzenden van een e-mail via de REST API extra gegevens (Extra Contact Velden) mee te geven, zonder deze permanent op te slaan in de database. Dit is handig bijvoorbeeld bij verlaten winkelmandjes, incomplete boekingen of andere scenario’s waarbij je tijdelijk data wilt tonen in de e-mail.

Vereisten

Je moet beschikken over een werkende API-verbinding met Spotler MailPro.

Beschikbare API-calls

/{campaignId}/contact/sendSingleMail

/{campaignId}/mailing/{id}/sendSingle

/{campaignId}/contacts/send

Voorbeeld: sendSingle call met Extra Contact Velden (REST)

Onderstaand JSON-voorbeeld laat zien hoe een sendSingle API-aanroep eruit kan zien wanneer je Extra Contact Velden meestuurt:

 {
  "contactId": 2,
  "attachments": [
  ],
  "extraContactData": [
    {
      "field": "DMD_hotel_name",
      "value": "Hotel Example"
    },
{
      "field": "DMD_checkin_date",
      "value": "01-01-2026"
    },
{
      "field": "DMD_checkout_date",
      "value": "07-01-2026"
    },
{
      "field": "DMD_checkout_url",
      "value": "https://spotler.com/checkout/example/12345678910"
    }
  ]
}

Weergave in Spotler MailPro

Content Editor (meest gebruikt)

Resultaat in de inbox

De extra gegevens die je hebt opgegeven in de API-call worden ingevuld in de e-mail, zoals je hieronder kunt zien:

Belangrijke aandachtspunten

De naam van Extra Contact Velden kun je zelf bepalen, maar deze moeten altijd beginnen met DMD_ zodat Spotler MailPro ze herkent.
Wanneer je HTML meestuurt met de extra contact data, zal de variabele hierop voorbereid moeten zijn middels een |raw bewerking.
Extra Contact Velden kunnen niet worden getoond in de webversie van de e-mail. Vermijd dus links in je mail naar de webversie als je extra velden gebruikt.

Artikelen in deze sectie