API resource
DM workflows
Multi-step DM conversations: a trigger (a keyword DM, a comment, a story mention, a reaction, a lead form, a referral link or your own API call) followed by messages, waits for a reply, conditions, delays, A/B splits, tags, custom fields, sequence enrolment, webhooks and a handoff to a person, joined by edges. Every string takes{{variable}}. Workflows are created as drafts; activate one to start answering. Steps of typeai and start_call are not available (400 node_not_available): call your own AI or phone system from a webhook step. For a single keyword → DM, Comment-to-DM automations are simpler.
Create a workflow
/v1/workflowsWorks on: Instagram, Facebook, WhatsApp, TikTok, X
Node types: trigger, send_message (messageType text, template, media, interactive or cards),wait_for_reply, condition, delay, a_b_split, set_variable, set_field,add_tag, remove_tag, enroll_sequence, webhook, hubspot_upsert_contact,handoff, end. An edge's sourceHandle picks a branch (a condition rulepicks a branch (for example true / falseapos;s id or defaultafter a condition, reply / timeout after a wait). The graph is checked on save; a reachable trigger is required to activate.
Body
accountIdstringrequiredThe account (acc_...) the post or conversation belongs to.
namestringrequiredWorkflow name.
platformstringinstagram, facebook, whatsapp, tiktok or twitter (default whatsapp). Match the account.
descriptionstringOptional.
nodesobject[]{ id, type, config }.
edgesobject[]{ id, source, target, sourceHandle? }.
entryNodeIdstringThe trigger node; derived when there is one.
curl -X POST "https://creatoros-production-5658.up.railway.app/v1/workflows" \
-H "Authorization: Bearer $CREATOROS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
"platform": "instagram",
"name": "Guide funnel",
"nodes": [
{
"id": "start",
"type": "trigger",
"config": {
"triggerType": "inbound_message",
"keywords": [
"GUIDE"
],
"matchType": "contains"
}
},
{
"id": "ask",
"type": "send_message",
"config": {
"messageType": "text",
"text": "Hey {{first_name}}! Want the free guide? Reply YES"
}
},
{
"id": "wait",
"type": "wait_for_reply",
"config": {
"timeoutMinutes": 1440,
"saveAs": "answer"
}
},
{
"id": "send",
"type": "send_message",
"config": {
"messageType": "text",
"text": "Here it is: https://example.com/guide"
}
},
{
"id": "tag",
"type": "add_tag",
"config": {
"tag": "guide"
}
},
{
"id": "end",
"type": "end",
"config": {}
}
],
"edges": [
{
"id": "e1",
"source": "start",
"target": "ask"
},
{
"id": "e2",
"source": "ask",
"target": "wait"
},
{
"id": "e3",
"source": "wait",
"target": "send",
"sourceHandle": "reply"
},
{
"id": "e4",
"source": "send",
"target": "tag"
},
{
"id": "e5",
"source": "tag",
"target": "end"
},
{
"id": "e6",
"source": "wait",
"target": "end",
"sourceHandle": "timeout"
}
]
}'{
"success": true,
"workflow": {
"id": "obj_NmKBwQiscS8gnUiLCiKa_KfNagDOAKMNQuSXeU44I25jeeDMwY14ow",
"name": "Guide funnel",
"platform": "instagram",
"status": "draft",
"nodeCount": 6,
"entryNodeId": "start"
}
}List workflows
/v1/workflowsWorks on: Instagram, Facebook, WhatsApp, TikTok, X
Every workflow with run stats (started, completed, exited). GET /v1/workflows/{workflowId} returns one with its full graph.
Query parameters
statusstringdraft, active or paused.
limitintegerDefault 50.
skipintegerFor paging.
curl "https://creatoros-production-5658.up.railway.app/v1/workflows" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"success": true,
"workflows": [
{
"id": "obj_NmKBwQiscS8gnUiLCiKa_KfNagDOAKMNQuSXeU44I25jeeDMwY14ow",
"name": "Guide funnel",
"platform": "instagram",
"accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
"status": "active",
"nodeCount": 6,
"totalStarted": 42,
"totalCompleted": 31,
"totalExited": 11
}
]
}Update a workflow
/v1/workflows/{workflowId}Works on: Instagram, Facebook, WhatsApp, TikTok, X
Change the name, description or graph; each save is a new version (GET .../versions,GET .../versions/{version}, POST .../versions/{version}/restore). Also on this path:DELETE, POST .../activate, POST .../pause, POST .../duplicate, POST .../trigger(run an api_call workflow for a contact), GET .../executions andGET .../executions/{executionId}/events.
Path parameters
workflowIdstringrequiredThe workflow id.
Body
namestringNew name.
nodesobject[]The full node list.
edgesobject[]The full edge list.
curl -X PATCH "https://creatoros-production-5658.up.railway.app/v1/workflows/obj_NmKBwQiscS8gnUiLCiKa_KfNagDOAKMNQuSXeU44I25jeeDMwY14ow" \
-H "Authorization: Bearer $CREATOROS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Guide funnel v2"
}'{
"success": true
}