Skip to main content
PATCH
Update your workflow

Headers

cal-api-version
string
required

Must be set to 2026-09-22 to use this version of the workflow endpoints.

Example:

"2026-09-22"

Authorization
string
required

value must be Bearer <token> where <token> is api key prefixed with cal_, managed user access token, or OAuth access token

Path Parameters

workflowId
number
required

Body

application/json
name
string

Name of the workflow

Example:

"Platform Test Workflow"

activation
object

Activation settings for the workflow

trigger
Before Event · object

Trigger configuration for the event-type workflow, allowed triggers are beforeEvent,eventCancelled,newEvent,afterEvent,rescheduleEvent,afterHostsCalVideoNoShow,afterGuestsCalVideoNoShow,bookingRejected,bookingRequested,bookingPaymentInitiated,bookingPaid,bookingNoShowUpdated

steps
(Email Address · object | Email Attendee · object | Email Host · object | SMS Attendee · object | WhatsApp Number · object | WhatsApp Attendee · object | SMS Number · object | Paths · object | Filter · object | Delay (existing step) · object | Lead enrichment (existing step) · object)[]

Steps to execute. This is the complete desired step list: omitted steps are deleted and omitted pathId makes a sending step unconditional. Omit steps entirely to preserve the graph. Existing delays and lead enrichment must still be echoed by id and keep their relative order.

Minimum array length: 1

Response

200 - application/json
status
enum<string>
required

Indicates the status of the response

Available options:
success,
error
Example:

"success"

data
object
required