Skip to main content
POST
Trigger a flow for a contact

Authorizations

Authorization
string
header
required

Workspace API key, e.g. Authorization: Bearer tented_.... Create keys in Workspace Settings → API Keys.

Path Parameters

flowId
string<uuid>
required

Flow ID.

Body

application/json
contact_id
string<uuid>

Existing contact ID. Provide exactly one of contact_id, email, or phone.

email
string<email>

Contact email, looked up against existing contacts.

phone
string

Contact phone, normalized and looked up against existing contacts.

tokens
object

Campaign token values keyed by name, validated against the fields declared on the flow’s tented_api trigger. Keys must start with a letter and contain only letters, numbers, and underscores; trigger is reserved. Values are JSON scalars (date fields take ISO 8601 strings).

Response

Contact enrolled (entry_source is trigger).

membership
object
required