Subscribe a contact

post

https://esputnik.com/api/v1/contact/subscribe

The method is used for the integration of subscription forms.
If a contact does not exist, it is created with the non-confirmed email.
If a contact exists, the contact fields are updated (except existing media channels).
New contacts are created with a not confirmed status.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

The method for double opt-in implementation. A created contact is unconfirmed.
It is impossible to send bulk emails to such contacts until they confirm their subscription; however, they are available for receiving important trigger messages.
An event will be automatically generated after this method is called.
Sending a confirmation email can be implemented using the mechanism of events and campaigns.
When clicking the link in the letter, a contact becomes confirmed and available for bulk emails sending.

contact

object

required

Contact for subscription.

groups

array of strings

The list of segment names where a new/updated contact will be added.

groups

subscriptions

array of strings

Subscription categories added for a contact.

subscriptions

formType

string

The subscription form name. It allows you to use several independent subscription forms.
All characters are acceptable, except: < ; ’ \ / | " ` ' ^ ? ! , >

Responses

400

Bad request

401

Unauthorized

405

Method not allowed

409

Conflict:

Repeated request within 1 minute.

415

Unsupported media type

429

Too many requests:

More than 200 requests per 1 second.

200