Skip to main content
Scalekit sends webhooks for these authentication events.

Authentication events

user.authenticated

User successfully authenticated.
{
  "type": "user.authenticated",
  "data": {
    "userId": "usr_1234567890",
    "organizationId": "org_1234567890",
    "email": "[email protected]",
    "method": "sso"
  }
}

user.authentication_failed

Authentication attempt failed.
{
  "type": "user.authentication_failed",
  "data": {
    "email": "[email protected]",
    "reason": "invalid_credentials"
  }
}

User events

user.created

New user created.
{
  "type": "user.created",
  "data": {
    "userId": "usr_1234567890",
    "email": "[email protected]",
    "organizationId": "org_1234567890"
  }
}

user.updated

User profile updated.
{
  "type": "user.updated",
  "data": {
    "userId": "usr_1234567890",
    "changes": ["email", "name"]
  }
}

user.deleted

User deleted.
{
  "type": "user.deleted",
  "data": {
    "userId": "usr_1234567890"
  }
}

Session events

session.created

New session started.
{
  "type": "session.created",
  "data": {
    "sessionId": "ses_1234567890",
    "userId": "usr_1234567890"
  }
}

session.expired

Session expired.
{
  "type": "session.expired",
  "data": {
    "sessionId": "ses_1234567890",
    "userId": "usr_1234567890"
  }
}

SSO events

connection.created

SSO connection configured.
{
  "type": "connection.created",
  "data": {
    "connectionId": "conn_1234567890",
    "organizationId": "org_1234567890",
    "type": "SAML"
  }
}

connection.enabled

SSO connection activated.
{
  "type": "connection.enabled",
  "data": {
    "connectionId": "conn_1234567890"
  }
}

SCIM events

scim.user_provisioned

User provisioned via SCIM.
{
  "type": "scim.user_provisioned",
  "data": {
    "userId": "usr_1234567890",
    "organizationId": "org_1234567890"
  }
}

scim.user_deprovisioned

User deprovisioned via SCIM.
{
  "type": "scim.user_deprovisioned",
  "data": {
    "userId": "usr_1234567890"
  }
}

Next steps

Webhooks overview

Getting started with webhooks

Webhook security

Security best practices

Build docs developers (and LLMs) love