SPsplio
Contact

Create a contact

Changed on

Create a contact.

post/data/contacts

Request

  • Base URL
    https://api.splio.com
  • URL
    https://api.splio.com/data/contacts
  • Auth
    HTTP bearer

Request body

lastnamestring
firstnamestring
creation_datestring

This date of creation of this contact, will be used for trigger campaigns, Ex: Welcome email. Warning the timezone set for this date is the user api timezone and not the system timezone.

languagestring

en, fr, it, es, ...

emailstring
cellphonestring
double_optinobject

[Optional] Require subscribers to confirm their subscription by sending a confirmation request.<br /> <br /> Legacy Version<br /> - message: id of the message that must be sent. This message must contain a link to $confirmUrl$<br /> - reminder: id of the reminder message. This message must contain $confirmUrl$ as well.<br /> - reminder_delay: if you want a reminder to be sent, specify the number of days between the first message and the reminder.<br /> { "message": "aw94xefgh", "reminder": "94was76ef", "reminder_delay": 34 } <br /> <br /> Splio Edition 2025<br /> - enabled: Enable double optin<br /> { "enabled": true }

Example request

{
  "lastname": "Doe",
  "firstname": "John",
  "creation_date": "2018-01-24 15:00:00",
  "language": "en",
  "email": "jdoe@mysite.com",
  "cellphone": "+331122334455",
  "lists": [
    {
      "id": 25,
      "name": "newsletter shoes"
    }
  ],
  "custom_fields": [
    {
      "name": "foo",
      "value": "bar"
    },
    {
      "name": "foo2",
      "value": "bar2"
    }
  ],
  "tracking_consent": [
    {
      "channel": "email",
      "scope": "open",
      "enabled": true,
      "date": "2026-07-01 10:00:00"
    }
  ]
}

Response

contact creation is successful.

Changes