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

POST/v1/workflows

Works 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

accountIdstringrequired

The account (acc_...) the post or conversation belongs to.

namestringrequired

Workflow name.

platformstring

instagram, facebook, whatsapp, tiktok or twitter (default whatsapp). Match the account.

descriptionstring

Optional.

nodesobject[]

{ id, type, config }.

edgesobject[]

{ id, source, target, sourceHandle? }.

entryNodeIdstring

The 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"
      }
    ]
  }'
Response 200
{
  "success": true,
  "workflow": {
    "id": "obj_NmKBwQiscS8gnUiLCiKa_KfNagDOAKMNQuSXeU44I25jeeDMwY14ow",
    "name": "Guide funnel",
    "platform": "instagram",
    "status": "draft",
    "nodeCount": 6,
    "entryNodeId": "start"
  }
}

List workflows

GET/v1/workflows

Works 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

statusstring

draft, active or paused.

limitinteger

Default 50.

skipinteger

For paging.

curl "https://creatoros-production-5658.up.railway.app/v1/workflows" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "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

PATCH/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

workflowIdstringrequired

The workflow id.

Body

namestring

New 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"
  }'
Response 200
{
  "success": true
}