Skip to content

Account
Webhook

Request

Security
X-Signature
Headers
X-Signaturestringrequired
Example:X-Signature: t=1492774577,v1=5257a869...
Bodyapplication/json

An account was created, updated or deleted.

versionstring

The version of the event.

Example:"1"
idstring, (uuid)

The unique identifier for the event. This can be used as an idempotency key.

Example:"c478966c-f927-411c-b919-179832d3d50c"
tenantIdstring, (uuid)

The unique identifier of the tenant the event belongs to.

Example:"4f9d2e7a-1b3c-4d5e-8f6a-7c8b9d0e1f2a"
timestampinteger

When the event occurred, formatted as a UNIX timestamp (in seconds).

Example:1698604061
categorystring

The category of the event.

Value:"ENTITY"
descriptionstring

The description of the event. Note: this is subject to change and should not be used to match on this object.

Example:"employee@example.com on Google Workspace updated"
typestring

The type of event that occurred.

Enum:"CREATE""UPDATE""DELETE"
objectstring

The object that was created, updated or deleted.

Value:"ACCOUNT"
friendlyNamestring

The friendly name of this object. Note: this is subject to change and should not be used to match on this object.

Example:"Account"
newobject(Account)

The new state of the object. This is null when the event type is DELETE.

oldobject(Account)

The previous state of the object. This is null when the event type is CREATE.

Payload
{
  "version": "1",
  "id": "c478966c-f927-411c-b919-179832d3d50c",
  "tenantId": "4f9d2e7a-1b3c-4d5e-8f6a-7c8b9d0e1f2a",
  "timestamp": 1698604061,
  "category": "ENTITY",
  "description": "employee@example.com on Google Workspace updated",
  "type": "CREATE",
  "object": "ACCOUNT",
  "friendlyName": "Account",
  "new": {
    "id": "d6a32ba5-0532-4a66-8137-48cdf409c972",
    "employeeId": "72d0347a-2663-4ef5-b1c5-df39163f1603",
    "appType": "ATLASSIAN",
    "appId": "2a2197de-ad2c-47e4-8dcb-fb0f04cf83e0",
    "email": "john.hill@example.com",
    "mfaRegistered": true,
    "mfaMethods": [
      "APP_TOTP"
    ],
    "passwordId": "4c13674f-e88a-4411-bfa2-53a70468a898",
    "loginMethods": {
      "passwordLogin": true,
      "oidcLogin": "GOOGLE_WORKSPACE",
      "samlLogin": "OKTA",
      "oktaSwaLogin": true,
      "vendorSsoLogin": "GOOGLE_WORKSPACE",
      "fedCmLogin": "GOOGLE_WORKSPACE"
    },
    "creationTimestamp": 1698064423,
    "lastUsedTimestamp": 1698669168
  },
  "old": {
    "id": "d6a32ba5-0532-4a66-8137-48cdf409c972",
    "employeeId": "72d0347a-2663-4ef5-b1c5-df39163f1603",
    "appType": "ATLASSIAN",
    "appId": "2a2197de-ad2c-47e4-8dcb-fb0f04cf83e0",
    "email": "john.hill@example.com",
    "mfaRegistered": true,
    "mfaMethods": [
      "APP_TOTP"
    ],
    "passwordId": "4c13674f-e88a-4411-bfa2-53a70468a898",
    "loginMethods": {
      "passwordLogin": true,
      "oidcLogin": "GOOGLE_WORKSPACE",
      "samlLogin": "OKTA",
      "oktaSwaLogin": true,
      "vendorSsoLogin": "GOOGLE_WORKSPACE",
      "fedCmLogin": "GOOGLE_WORKSPACE"
    },
    "creationTimestamp": 1698064423,
    "lastUsedTimestamp": 1698669168
  }
}

Responses

Return any 2XX status to indicate that the data was received successfully