v2

latestOpenAPI 3.1.12026-07-2613060964.2 KB

Create / Update Objects

API to upsert (create if not exists, update if exists) object by providing a unique object ID and type.

post/v1/object/{object_type}/{id}/

Path parameters

idstring required

Unique identifier of the object in your system

object_typestring required

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

Request body

$emailstring[]

List of email addresses.

$smsstring[]

List of phone numbers for SMS

$whatsappstring[]

List of phone numbers for WhatsApp

$inboxstring[]

List of inbox identifiers

$androidpushstring[]

List of Android Push tokens

$iospushstring[]

List of iOS Push tokens

$timezonestring

Object's timezone in IANA format

$localestring

Object's locale for translating template content in SuprSend.

Example request

{
  "$slack": [
    {
      "email": "user@example.com",
      "access_token": "xoxb-XXXXXXXX"
    }
  ],
  "$ms_teams": [
    {
      "tenant_id": "c1981ab2-9aaf-xxxx-xxxx",
      "service_url": "https://smba.trafficmanager.net/amer",
      "conversation_id": "19:c1524d7c-a06f-456f-8abe-xxxx"
    }
  ],
  "$timezone": "America/New_York",
  "$locale": "en_GB"
}

Response

201 - Created

idstring

unique identifier of the object

object_typestring

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

subscriptions_countinteger

number of users/child objects subscribed to the object

propertiesobject

all user properties in key-value pair. SuprSend reserved properties start with $

created_atstring date-time

Timestamp when the object was created.

updated_atstring date-time

Timestamp when the object was last updated.

Example response

{
  "id": "engineering",
  "object_type": "departments",
  "created_at": "2025-04-04T09:55:12.397856+00:00",
  "updated_at": "2025-04-04T09:55:12.422388+00:00",
  "$<channel>": [
    {
      "status": "active"
    }
  ]
}