How to trigger a Workflow using Webhook? – Wire2Air Customer Service Portal

Overview

A Webhook trigger lets an external system start a workflow for a specific contact by sending an HTTP request — no inbound SMS keyword required. When the webhook is called with a valid mobile number, TXTImpact starts the workflow for that contact exactly as if they had texted the trigger keyword.

1. Create the webhook trigger

Open your workflow and click the Trigger (Start) node.
In Trigger Settings, click Add Trigger.
Choose Webhook (external) and click Add.
A unique URL is generated for the trigger. Click the copy icon to copy it.

Each webhook trigger has its own secret token embedded in the URL. Treat the URL like a password — anyone who has it can start the workflow.

2. Send the request

Method	`POST`
URL	The URL shown in Trigger Settings, e.g. `https://<your-api-host>/api/v2/WorkflowTrigger/{token}`
Headers	`Content-Type: application/json`

3. Request payload

Field	Required	Description
`mobileNumber`	Yes	The contact's mobile number in full international format (e.g. `15551234567`). The contact does not need to already exist.
`subscriberName`	No	The contact's name, used in the workflow where applicable.
`message`	No	Text to use as the contact's first message. If omitted, the workflow starts as if the trigger keyword was received.

4. Example

curl -X POST "https://<your-api-host>/api/v2/WorkflowTrigger/{token}" \
  -H "Content-Type: application/json" \
  -d '{
        "mobileNumber": "15551234567",
        "subscriberName": "Jane Doe",
        "message": "START"
      }'

5. Responses

Status	Body	Meaning
`200`	`{ "result": "accepted" }`	The workflow was started for the contact.
`400`	`{ "result": "mobileNumber is required" }`	The payload was missing a mobile number.
`404`	`{ "result": "Unknown or disabled trigger token" }`	The token is invalid, deleted, or the trigger is disabled.

Notes

Already in the workflow: if the contact already has an open session for this workflow, the webhook call is ignored (logged) rather than starting a duplicate conversation.
Disabling: toggle the trigger off in Trigger Settings to stop accepting calls without deleting it; delete it to invalidate the URL permanently.
Auditing: every webhook call (started, skipped, or rejected) is recorded for troubleshooting.

Articles in this section