Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

connected_account.status_updated

Triggered when a connected account's status changes between two states (for example PENDING_AUTH to ACTIVE, ACTIVE to EXPIRED, or any state to DISCONNECTED). Not triggered on account creation.

This page as markdownListen for account events

Delivery

Scalekit sends the event as a JSON POST to your webhook endpoint, signed in the webhook-id, webhook-timestamp and webhook-signature headers. Verify the signature before you act on it; see Listen for account events.

Payload

dataobject
The connected account whose status changed, including its previous status.
Show 8 child attributes
authorization_typestring (enum)
The authorization type of the connected account
OAUTHAPI_KEYBASIC_AUTHBEARER_TOKENCUSTOMBASICOAUTH_M2MTRELLO_OAUTH1GOOGLE_DWDTRUSTED_IDPSMART_FHIRNO_AUTH
connection_idstring
The connection's ID.
idstring
The connected account's ID.
identifierstring
Your app's ID for the user, the value passed when the account was created.
old_statusstring (enum)
The previous status of the connected account
ACTIVEEXPIREDPENDING_AUTHPENDING_VERIFICATIONDISCONNECTED
providerstring
The app, such as GMAIL.
statusstring (enum)
The new status of the connected account
ACTIVEEXPIREDPENDING_AUTHPENDING_VERIFICATIONDISCONNECTED
connection_namestring
The connection's name, as shown in AgentKit > Connections. Omitted when it cannot be resolved.
environment_idstring
The environment ID where the event occurred
idstring
Unique identifier for the webhook event (must be prefixed with "evt_")
objectstring (enum)
The type of object that triggered the webhook
ConnectedAccount
occurred_atstring
When the event occurred (ISO 8601 format)
spec_versionstring
The webhook specification version
typestring (enum)
The event type
connected_account.status_updated