POST
/
v1
/
object
/
{object_type}
/
{id}
/
subscription
/
Add Subscription
curl --request POST \
  --url https://hub.suprsend.com/v1/object/{object_type}/{id}/subscription/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "recipients": [
    {
      "distinct_id": "id1",
      "$email": [
        "<string>"
      ],
      "$preferred_language": "<string>",
      "$timezone": "<string>"
    }
  ],
  "properties": {
    "role": "developer"
  }
}'
{
  "results": [
    {
      "properties": {
        "department": "frontend"
      },
      "user": {
        "distinct_id": "_distinct_id_",
        "updated_at": "2025-04-05T10:33:33.629736+00:00"
      },
      "object": {
        "id": "_object_id_",
        "object_type": "_object_type_",
        "subscriptions_count": 10,
        "updated_at": "2025-04-06T11:00:24.257046+00:00"
      },
      "created_at": "2025-04-06T10:59:07.726336+00:00",
      "updated_at": "2025-04-06T10:59:07.726336+00:00"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Pass as Bearer <API_KEY>. Get API Key from SuprSend dashboard Developers -> API Keys section.

Path Parameters

​
id
string
required

Unique identifier of the object in your system

​
object_type
string
required

Used to group similar objects together. Give plural namespace like teams, organizations, and roles.

Body

application/json

Response

200
application/json

200

The response is of type object.