Type Oauth App Grant

Description

Notification about an OAUTH_APP_GRANT event.

Response Body

Parent	Name	Output
$.	data[]
data[]	orgId
data[]	id
data[]	createdDate
data[]	feedbackUrl
data[]	resourceDetails
data[]	type
resourceDetails	resourceId
resourceDetails	resourceType

Resource ID

resourceDetails.resourceId (string) identifies the organization that created the OAuth App, not the organization that uses it.

Example Response Bodies

Partner Notification

Location owner revokes an (OAuth) authorization grant. Event triggers generation of a notification that is available to the partner which created the OAuth App.

Notification For	Process Initiated by
Partner	Location owner

• Partner calls the notification API using their own orgId as the URI parameter, along with their own access token, to retrieve the notification.

{
  "data": [
    {
      "orgId": "9467895078742654994",
      "id": "9467895078742654921",
      "createdDate": "2026-10-20T01:32:59.00Z",
      "type": "OAUTH_APP_GRANT",
      "feedbackUrl": "/v1/orgs/9467895078742654994/feedback?ql=id==9467895078742654951",
      "resourceDetails": {
        "resourceType": "ORGANIZATION",
        "resourceId": "9467895078742654994"
      }
    }
  ],
  "pagination": {
    "cursors": {
      "after": "5X23a61d9b495619"
    },
    "next": "/v1/orgs/9467895078742654994/notifications?ql=resourceType==ORGANIZATION&limit=1&after=5X23a61d9b495619"
  }
}

Location Owner Notification

Scenario also triggers generation of a notification that is available to the location owner whose user revoked an authorization grant.

Notification For	Process Initiated by
Location owner	Location owner

• Location owner calls the notification API using their own orgId as the URI parameter, along with their own access token, to retrieve the notification.

{
  "data": [
    {
      "orgId": "9467895078742650123",
      "id": "9467895078742654932",
      "createdDate": "2026-10-20T01:32:01.00Z",
      "type": "OAUTH_APP_GRANT",
      "feedbackUrl": "/v1/orgs/9467895078742650123/feedback?ql=id==9467895078742654978",
      "resourceDetails": {
        "resourceType": "ORGANIZATION",
        "resourceId": "9467895078742654994"
      }
    }
  ],
  "pagination": {
    "cursors": {
      "after": "1D44a61d9b495227"
    },
    "next": "/v1/orgs/9467895078742650123/notifications?ql=resourceType==ORGANIZATION&limit=1&after=1D44a61d9b495227"
  }
}