Circleback

Circleback provides 3 triggers for automating workflows based on events.

Triggers

Trigger workflow when a meeting is processed and ready in Circleback

Parameter	Type	Required	Description
`webhookSecret`	string	No	Validates that webhook deliveries originate from Circleback using HMAC-SHA256.

Parameter	Type	Description
`id`	number	Circleback meeting ID
`name`	string	Meeting title/name
`url`	string	URL of the virtual meeting (Zoom, Google Meet, Teams, etc.)
`createdAt`	string	ISO8601 timestamp when meeting was created
`duration`	number	Meeting duration in seconds
`recordingUrl`	string	Recording URL (valid for 24 hours, if enabled)
`tags`	array	Array of tag strings
`icalUid`	string	Calendar event identifier
`attendees`	array	Array of attendee objects with name and email
↳ `name`	string	Attendee name
↳ `email`	string	Attendee email address
`notes`	string	Meeting notes in Markdown format
`actionItems`	array	Array of action item objects
↳ `id`	number	Action item ID
↳ `title`	string	Action item title
↳ `description`	string	Action item description
↳ `assignee`	object	Person assigned to the action item (or null)
↳ `name`	string	Assignee name
↳ `email`	string	Assignee email
↳ `status`	string	Status: PENDING or DONE
`transcript`	array	Array of transcript segments
↳ `speaker`	string	Speaker name
↳ `text`	string	Transcript text
↳ `timestamp`	number	Timestamp in seconds
`insights`	object	User-created insights keyed by insight name
`meeting`	object	Full meeting payload object
↳ `id`	number	Meeting ID
↳ `name`	string	Meeting name
↳ `url`	string	Meeting URL
↳ `duration`	number	Duration in seconds
↳ `createdAt`	string	Creation timestamp
↳ `recordingUrl`	string	Recording URL

Trigger workflow when meeting notes and action items are ready

Parameter	Type	Required	Description
`webhookSecret`	string	No	Validates that webhook deliveries originate from Circleback using HMAC-SHA256.

Parameter	Type	Description
`id`	number	Circleback meeting ID
`name`	string	Meeting title/name
`url`	string	URL of the virtual meeting (Zoom, Google Meet, Teams, etc.)
`createdAt`	string	ISO8601 timestamp when meeting was created
`duration`	number	Meeting duration in seconds
`recordingUrl`	string	Recording URL (valid for 24 hours, if enabled)
`tags`	array	Array of tag strings
`icalUid`	string	Calendar event identifier
`attendees`	array	Array of attendee objects with name and email
↳ `name`	string	Attendee name
↳ `email`	string	Attendee email address
`notes`	string	Meeting notes in Markdown format
`actionItems`	array	Array of action item objects
↳ `id`	number	Action item ID
↳ `title`	string	Action item title
↳ `description`	string	Action item description
↳ `assignee`	object	Person assigned to the action item (or null)
↳ `name`	string	Assignee name
↳ `email`	string	Assignee email
↳ `status`	string	Status: PENDING or DONE
`transcript`	array	Array of transcript segments
↳ `speaker`	string	Speaker name
↳ `text`	string	Transcript text
↳ `timestamp`	number	Timestamp in seconds
`insights`	object	User-created insights keyed by insight name
`meeting`	object	Full meeting payload object
↳ `id`	number	Meeting ID
↳ `name`	string	Meeting name
↳ `url`	string	Meeting URL
↳ `duration`	number	Duration in seconds
↳ `createdAt`	string	Creation timestamp
↳ `recordingUrl`	string	Recording URL

Generic webhook trigger for all Circleback events

Parameter	Type	Required	Description
`webhookSecret`	string	No	Validates that webhook deliveries originate from Circleback using HMAC-SHA256.

Parameter	Type	Description
`id`	number	Circleback meeting ID
`name`	string	Meeting title/name
`url`	string	URL of the virtual meeting (Zoom, Google Meet, Teams, etc.)
`createdAt`	string	ISO8601 timestamp when meeting was created
`duration`	number	Meeting duration in seconds
`recordingUrl`	string	Recording URL (valid for 24 hours, if enabled)
`tags`	array	Array of tag strings
`icalUid`	string	Calendar event identifier
`attendees`	array	Array of attendee objects with name and email
↳ `name`	string	Attendee name
↳ `email`	string	Attendee email address
`notes`	string	Meeting notes in Markdown format
`actionItems`	array	Array of action item objects
↳ `id`	number	Action item ID
↳ `title`	string	Action item title
↳ `description`	string	Action item description
↳ `assignee`	object	Person assigned to the action item (or null)
↳ `name`	string	Assignee name
↳ `email`	string	Assignee email
↳ `status`	string	Status: PENDING or DONE
`transcript`	array	Array of transcript segments
↳ `speaker`	string	Speaker name
↳ `text`	string	Transcript text
↳ `timestamp`	number	Timestamp in seconds
`insights`	object	User-created insights keyed by insight name
`meeting`	object	Full meeting payload object
↳ `id`	number	Meeting ID
↳ `name`	string	Meeting name
↳ `url`	string	Meeting URL
↳ `duration`	number	Duration in seconds
↳ `createdAt`	string	Creation timestamp
↳ `recordingUrl`	string	Recording URL