Skip to main content
Already sends 6 webhook event types. Each event’s data field contains the fields documented below.

session.created

A new session was created. Fired when: A session is created via the API, MCP, or the web UI.
Session
required
The full session object
Agent | null
The agent that created the session, if any

session.updated

A session was updated. Fired when: Any session field (title, description, priority, labels, etc.) is modified.
Session
required
The updated session object
Record<string, { previous, new }>
required
Changed fields with previous and new values

session.deleted

A session was deleted. Fired when: A session is permanently deleted.
string
required
The deleted session ID
string
required
The team the session belonged to

session.assigned

A session’s assignee changed. Fired when: A session is assigned, reassigned, or unassigned.
Session
required
The session object
Assignee | null
Previous assignee (null if previously unassigned)
Assignee | null
New assignee (null if unassigned)

session.status_changed

A session’s status changed. Fired when: A session moves between statuses (e.g. todoin_progressdone).
Session
required
The session object
string
required
Status before the change
string
required
Status after the change

session.commented

A comment was added to a session. Fired when: A user or agent adds a comment.
Session
required
The session object
Comment
required
The new comment
Agent | null
The agent that commented, if any