POST
/
v1
/
subscribers
curl --location 'https://api.novu.co/v1/subscribers' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: ApiKey <NOVU_API_KEY>' \
  --data-raw '{
    "firstName": "Pawan",
    "lastName": "Jain",
    "email": "pawan.jain@domain.com",
    "phone": "+1234567890",
    "avatar": "avatar-url",
    "locale": "en-US",
    "data": {
      "isDeveloper": true,
      "customKey": "customValue"
      }
    }'

{
    "data": {
        "_organizationId": "abcd12349876wxyz1234wxyz",
        "_environmentId": "zyxw4321abcd1234lmno5678",
        "firstName": "Alex",
        "lastName": "Benjamin",
        "phone": "123456789",
        "subscriberId": "abcd1234",
        "email": "alex@email.com",
        "avatar": "string",
        "locale": "en-US",
        "channels": [],
        "_id": "6516ed5a9d727fe8256028ed",
        "deleted": false,
        "createdAt": "2023-09-29T15:29:30.667Z",
        "updatedAt": "2023-09-29T15:29:30.667Z",
        "__v": 0,
        "id": "6516ed5a9d727fe8256028ed"
    }
}

Enter your API key in the Authorization field like the example shown below:

E.g ApiKey 18d2e625f05d80e

curl --location 'https://api.novu.co/v1/subscribers' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: ApiKey <NOVU_API_KEY>' \
  --data-raw '{
    "firstName": "Pawan",
    "lastName": "Jain",
    "email": "pawan.jain@domain.com",
    "phone": "+1234567890",
    "avatar": "avatar-url",
    "locale": "en-US",
    "data": {
      "isDeveloper": true,
      "customKey": "customValue"
      }
    }'

{
    "data": {
        "_organizationId": "abcd12349876wxyz1234wxyz",
        "_environmentId": "zyxw4321abcd1234lmno5678",
        "firstName": "Alex",
        "lastName": "Benjamin",
        "phone": "123456789",
        "subscriberId": "abcd1234",
        "email": "alex@email.com",
        "avatar": "string",
        "locale": "en-US",
        "channels": [],
        "_id": "6516ed5a9d727fe8256028ed",
        "deleted": false,
        "createdAt": "2023-09-29T15:29:30.667Z",
        "updatedAt": "2023-09-29T15:29:30.667Z",
        "__v": 0,
        "id": "6516ed5a9d727fe8256028ed"
    }
}

Authorizations

​
Authorization
string
header
required

API key authentication. Allowed headers-- "Authorization: ApiKey <api_key>".

Body

application/json

Response

201
application/json

Created

The response is of type object.