Skip to main content
POST
/
trigger
curl --request POST \
  --url 'https://hub.suprsend.com/trigger/' \
  --header 'Authorization: Bearer __your_api_key__' \
  --header 'Content-Type: application/json' \
  --data '{
    "workflow": "demo_notification_workflow",
    "recipients": [
      {
        "distinct_id": "user123",
        "$email": ["user@example.com"]
      }
    ],
    "data": {
      "user_name": "John Doe",
      "welcome_message": "Welcome to our platform!"
    }
  }'
{
  "message_id": "a1b2c3d4-e5f6-7890-abcd-ef0123456789",
  "status": "success"
}

Documentation Index

Fetch the complete documentation index at: https://docs.suprsend.com/llms.txt

Use this file to discover all available pages before exploring further.

Bulk trigger uses this same endpoint (POST /trigger/), just pass array of entire workflow object in the body.

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Send a single workflow trigger object as the request body.

​
workflow
string
default:_workflow_slug_
required

You can get workflow slug from workflow settings on SuprSend dashboard.

​
recipients
(Identify user inline · object | Notify object · object)[]
required

List of recipients to be notified. You can either add recipient as array of distinct_ids or array of recipient objects. You can add up to 100 recipients in a single API.

You can pass user properties and channels inline in workflow trigger request. Properties and channels passed here also update in user profile on workflow trigger.

​
actor
object

Includes distinct_id and properties of the user who performed the action. You can use it for cross-user notifications [blocked]. Actor properties can be added as $actor.<prop>.

​
data
object

variable data required to render dynamic template content or workflow properties like dynamic delay or channel override in send node.

​
tenant_id
string

string identifier of the tenant/tenant this workflow is associated with. Used to trigger multi-tenant notifications

​
$idempotency_key
string

Idempotency_key (valid for 24hrs)

Response

202 - Accepted (returned for single workflow trigger requests).

All workflow requests will be accepted as long as the API request is correct. To verify if the execution was successful, check the 'Requests' tab under the 'Logs' section on the SuprSend dashboard.

​
message_id
string

Unique identifier of the message generated by SuprSend.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef0123456789"

​
status
string
Example:

"success"