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
Session
required
The full session object
​
created_by
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
Session
required
The updated session object
​
changes
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.
​
session_id
string
required
The deleted session ID
​
team_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
Session
required
The session object
​
previous_assignee
Assignee | null
Previous assignee (null if previously unassigned)
​
new_assignee
Assignee | null
New assignee (null if unassigned)

​
session.status_changed

A session’s status changed. Fired when: A session moves between statuses (e.g. todo → in_progress → done).
​
session
Session
required
The session object
​
previous_status
string
required
Status before the change
​
new_status
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
Session
required
The session object
​
comment
Comment
required
The new comment
​
agent
Agent | null
The agent that commented, if any