Skip to content
/
App

App
Webhook

Request

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

An app 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
typestring

The type of event that occurred.

Enum:"CREATE""UPDATE""DELETE"
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:"Google Workspace first observed"
objectstring

The object that was created, updated or deleted.

Value:"APP"
friendlyNamestring

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

Example:"App"
newobject(App)

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

oldobject(App)

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,
  "type": "CREATE",
  "category": "ENTITY",
  "description": "Google Workspace first observed",
  "object": "APP",
  "friendlyName": "App",
  "new": {
    "id": "2a2197de-ad2c-47e4-8dcb-fb0f04cf83e0",
    "type": "ZAPIER",
    "approvalStatus": "UNDER_REVIEW",
    "sensitivityLevel": "HIGH",
    "ownerId": "87569da6-fb7a-4df7-8ce2-246c14044911",
    "notes": "Last security audit: 16 January 2023.\n",
    "categories": [
      {
        "code": 83,
        "name": "AI/ML Applications",
        "group": "Technology"
      }
    ],
    "creationTimestamp": 1698064423
  },
  "old": {
    "id": "2a2197de-ad2c-47e4-8dcb-fb0f04cf83e0",
    "type": "ZAPIER",
    "approvalStatus": "UNDER_REVIEW",
    "sensitivityLevel": "HIGH",
    "ownerId": "87569da6-fb7a-4df7-8ce2-246c14044911",
    "notes": "Last security audit: 16 January 2023.\n",
    "categories": [
      {
        "code": 83,
        "name": "AI/ML Applications",
        "group": "Technology"
      }
    ],
    "creationTimestamp": 1698064423
  }
}

Responses

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