ChatofyDevelopers
REST APIMCP Server (AI)New
API KeysWebhooks
Chatofy API
/
Getting Started
API Resources
API v1.0 Live
Developer APIChatbot Flows & AutomationsTrigger Flow

Trigger Flow

Manually initiates an interactive visual chatbot flow or automation for a contact.

POST/api/v1/flows/trigger

Request Body Schema

application/json
flow_iduuidrequired

Flow UUID to execute

Example:flw-uuid-001
phonestringoptional

Recipient phone number in E.164 format

Example:+919876543210
contact_iduuidoptional

Recipient contact UUID

variablesobjectoptional

Optional key-value context variables for the flow run

Response Payload

200 OKapplication/json
statusstring

"1" = Success, "0" = Failure.

messageobject

The response data payload.

Code Snippets & Examples

1curl -X POST "https://app.chatofy.in/api/v1/flows/trigger" \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{"flow_id":"flw-uuid-001","phone":"+919876543210"}'

Was this endpoint guide helpful?

Previous Endpoint
List Flows
Next Endpoint
MCP Streamable HTTP
© 2026 Chatofy Cloud Platform. All rights reserved.
1curl -X POST "https://app.chatofy.in/api/v1/flows/trigger" \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{"flow_id":"flw-uuid-001","phone":"+919876543210"}'
200 OKapplication/json
1{
2 "success": true,
3 "data": {
4 "flow_run_id": "run-uuid-001",
5 "flow_id": "flw-uuid-001",
6 "contact_id": "cnt-uuid-001",
7 "conversation_id": "conv-uuid-001",
8 "status": "active"
9 },
10 "message": "Flow triggered successfully"
11}