Trigger Workflow (single or bulk)

Changed on

API to trigger multi-step workflow to one or more users/objects by passing workflow slug, via POST /trigger/.

Send a single JSON object to trigger one workflow, or an array of objects to trigger multiple workflows in one call.

post/trigger/

Request

Request body

OR

Example request

{
  "recipients": [
    {
      "$channels": [
        "email"
      ],
      "$email": [
        "john@example.com"
      ],
      "$sms": [
        "+1234567890"
      ],
      "$inbox": [
        "4nlPk4t4kurG5kChxxxx"
      ],
      "$androidpush": [
        "__android_push_token__"
      ],
      "$iospush": [
        "__ios_push_token__"
      ],
      "$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",
      "$context": {
        "tenant_id": "acme-corp"
      }
    }
  ],
  "data": {
    "$attachments": [
      {
        "url": "https://bitcoincore.org/bitcoin.pdf",
        "filename": "billing.pdf"
      }
    ]
  },
  "cancellation_key": "booking-123"
}

Response

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

message_idstring

Unique identifier of the message generated by SuprSend.

statusstring

Example response

{
  "message_id": "a1b2c3d4-e5f6-7890-abcd-ef0123456789",
  "status": "success"
}

Changes

    • info

      added the new optional request property /

    • info

      added the new optional request property //

    • warning

      removed the request property //

    • warning

      removed the request property ///

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status