Subscriber

Create or update a Subscriber

Requirements

To use the subscriber endpoint, requests must be made against a base URL of https://api-gw.emotiveapp.co/ Requests are authenticated using an Authorization header with value: Token <YOUR_API_KEY> .

You must send at least a phone_number oremail as required fields for creating/updating a subscriber

subscribe_identifier is available from the Subscriber Lists endpoint

When submitting new SMS subscribers from an external source, The following are required:

• Properly formatted Authorization header

• phone_number

• source_type = LIST_GROWTH

• subscribe_identifier. The value is found in the emotive application with List Growth->Integrations

The following parameters should not be included

• platform

• popup_identifier

• subsource_identifier

post

Create a subscriber.

Body

application/json

anyOptional

or

anyOptional

Responses

202

Webhook Accepted.

application/json

400

Bad Request

application/json

post

/v1/subscriber

HTTPcURLJavaScriptPython

POST /sensus-webhook/v1/subscriber HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 438

{
  "birthdate": "text",
  "context": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "email": "text",
  "external_identifiers": {
    "custom": [
      {
        "name": "text",
        "value": "text"
      }
    ],
    "klaviyo": "text",
    "shopify": "text"
  },
  "first_name": "text",
  "last_name": "text",
  "phone_number": "text",
  "platform": "alloy",
  "popup_identifier": "text",
  "properties": [
    {
      "key": "text",
      "type": "string",
      "value": "text"
    }
  ],
  "source_type": "EMOTIVE_POPUP",
  "subscribe_identifier": "text",
  "subsource_identifier": "text"
}

{
  "message": "text"
}

Subscriber Lists