Execute a stored workflow for a visible contact

Requires a verified current member session or configured backend automation credential. Source labels provide no authority. Resource IDs must belong to the selected workspace; member contact visibility is checked. Inline definitions and database-lookup bypasses are rejected.

POST

https://api.channelautomation.com/api/unified-workflow/execute-for-contact

Authorization

BearerAuth
optional
HTTP Bearer (JWT)

BackendTriggerAuth
optional
API key in header

Header parameters

X-Workspace-Id
string
required

Request body JSON required

Returns

200

Existing successful result

400

Invalid resource input or workflow override

401

Missing or invalid caller identity

403

Workspace conflict or contact visibility denied

404

Resource not found in the selected workspace

503

Identity

Execute a stored workflow for a visible contact

curl --request POST \
  --url https://api.channelautomation.com/api/unified-workflow/execute-for-contact \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Workspace-Id: string' \
  --data '{}'

const url = 'https://api.channelautomation.com/api/unified-workflow/execute-for-contact';
const options = {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Workspace-Id': 'string',
    Authorization: 'Bearer <token>'
  },
  body: JSON.stringify({})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.channelautomation.com/api/unified-workflow/execute-for-contact"

payload = {}
headers = {
    "Content-Type": "application/json",
    "X-Workspace-Id": "string",
    "Authorization": "Bearer <token>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)