Webhook Events
Connection expired
Fired when a connected account expires and needs re-authentication.
WEBHOOK
composio.connected_account.expired
{
"id": "msg_9c8b7a6d-5e4f-4a3b-2c1d-0e9f8a7b6c5d",
"type": "composio.connected_account.expired",
"timestamp": "2026-01-15T10:30:00Z",
"metadata": {
"project_id": "proj_abc123",
"org_id": "org_abc123"
},
"data": {
"id": "ca_a1b2c3d4e5f6g7h8",
"toolkit": {
"slug": "github"
},
"auth_config": {
"id": "ac_x1y2z3a4b5c6",
"auth_scheme": "OAUTH2",
"is_composio_managed": true,
"is_disabled": false
},
"word_id": "github_red-castle",
"alias": null,
"user_id": "user-123",
"status": "EXPIRED",
"created_at": "2026-01-10T09:00:00Z",
"updated_at": "2026-01-15T10:30:00Z",
"state": {
"authScheme": "OAUTH2",
"val": {
"status": "EXPIRED"
}
},
"data": {},
"params": {},
"status_reason": "Connected account authentication expired.",
"is_disabled": false
}
}Headers
Body
application/json
Response
200
Return any 2xx status to acknowledge receipt. Non-2xx responses are retried.
{
"id": "msg_9c8b7a6d-5e4f-4a3b-2c1d-0e9f8a7b6c5d",
"type": "composio.connected_account.expired",
"timestamp": "2026-01-15T10:30:00Z",
"metadata": {
"project_id": "proj_abc123",
"org_id": "org_abc123"
},
"data": {
"id": "ca_a1b2c3d4e5f6g7h8",
"toolkit": {
"slug": "github"
},
"auth_config": {
"id": "ac_x1y2z3a4b5c6",
"auth_scheme": "OAUTH2",
"is_composio_managed": true,
"is_disabled": false
},
"word_id": "github_red-castle",
"alias": null,
"user_id": "user-123",
"status": "EXPIRED",
"created_at": "2026-01-10T09:00:00Z",
"updated_at": "2026-01-15T10:30:00Z",
"state": {
"authScheme": "OAUTH2",
"val": {
"status": "EXPIRED"
}
},
"data": {},
"params": {},
"status_reason": "Connected account authentication expired.",
"is_disabled": false
}
}