Type Delegation

Description

Notification about a DELEGATION event. DELEGATION notifications are scoped to location resources. This notification type is generated when a delegated brand location is created, updated, or deleted.

DELEGATION notifications are not generated for brand-level events. Brand lifecycle events — such as a brand entering a partner's delegation scope, or a delegated brand being updated or deleted — do not generate DELEGATION notifications. Delegated partners receive no notification of this type when a brand within their delegation scope is created, updated, or deleted.

Response Body

Parent	Name	Output
$.	data[]
data[]	orgId
data[]	id
data[]	createdDate
data[]	feedbackUrl
data[]	operation
data[]	resourceDetails
data[]	type
resourceDetails	resourceId
resourceDetails	resourceType
resourceDetails	state
resourceDetails	delegationDetails
delegationDetails	orgId
delegationDetails	orgLegalName
delegationDetails	state
resourceDetails	brandId
resourceDetails	etag

Brand ID

brandId (string) is the unique identifier of the brand associated with the delegated location. This field is only applicable for delegation notifications related to locations, and will be present when a location is delegated to a partner, or when a delegated location is updated or deleted.

Etag

etag (string) is the unique identifier representing a specific version of the resource. This field is only applicable for delegation notifications related to locations, and will be present when a location is delegated to a partner, or when a delegated location is updated or deleted. Delegated partners can use the etag value to determine if their local copy of the resource is up to date, and to detect if any changes have been made to the resource since it was last retrieved.

Operation

operation (string) identifies the API operation invoked by an organization. Possible values: CREATE, DELETE, or UPDATE.

Org ID

delegationDetails.orgId (string) identifies the organization that delegated you.

State

state (string) describes the delegation relationship that exists between the organizations (location owner/partner). Possible values: ACTIVE, INACTIVE, or PENDING.

Example Response Bodies

Location Delegation

A CREATE delegation notification is generated for a partner when a location falls within the scope of an active brand delegation. For organizations operating at scale, a brand is delegated to a partner with location management included as a delegated feature. When a location is associated with that brand, the partner receives this notification. The brandId field identifies the brand the location belongs to, giving the partner the context needed to manage the location within the brand's identity.

Notification For	Process Initiated by	Triggering Event
All partners whose delegation scope includes the brand	Location owner	Location associated with a delegated brand enters partner's scope

Delegated 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": "9467895078742654965",
      "createdDate": "2026-10-02T01:32:59.00Z",
      "type": "DELEGATION",
      "feedbackUrl": "/v1/orgs/9467895078742654994/feedback?ql=id==9467895078742654965",
      "resourceDetails": {
        "resourceType": "LOCATION",
        "resourceId": "9467895078742654976",
        "etag": "70f644aa-3356-11f1-8de9-0242ac120002",
        "state": "PUBLISHED",
        "delegationDetails": {
          "orgId": "9467895078742654911",
          "orgLegalName": "Small Business",
          "state": "ACTIVE"
        },
        "brandId": "1558030774494855185"
      }
    }
  ],
  "pagination": {
    "cursors": {
      "after": "9N14a61d9b495122"
    },
    "next": "/v1/orgs/9467895078742654994/notifications?ql=createdDate=ge=2026-07-01T00:00:00Z&limit=1&after=9N14a61d9b495122"
  }
}