Register a webhook endpoint owned by this installation.

POST

/apps/webhooks/subscriptions

curl --request POST \
  --url https://your-store.myciqra.com/apps/webhooks/subscriptions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "description": "example", "eventTypes": [ "example" ], "url": "example" }'

Required scope: write_webhooks — an installation token without it receives 403.

Authorizations

• bearerAuth
  write_webhooks

Request Body^required

Media typeapplication/json

object

description

required

null | string

eventTypes

required

Array<string> | null

url

required

null | string

Example^generated

{
  "description": "example",
  "eventTypes": [
    "example"
  ],
  "url": "example"
}

Responses

200

OK

Media typeapplication/json

object

createdAt

required

string format: date-time

description

required

null | string

eventTypes

required

Array<string>

hasSigningSecret

required

boolean

id

required

string format: uuid

installationId

null | string format: uuid

isActive

required

boolean

isDeliverable

required

boolean

updatedAt

required

null | string format: date-time

url

required

string

Example^generated

{
  "createdAt": "2026-04-15T12:00:00Z",
  "description": "example",
  "eventTypes": [
    "example"
  ],
  "hasSigningSecret": true,
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "installationId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "isActive": true,
  "isDeliverable": true,
  "updatedAt": "2026-04-15T12:00:00Z",
  "url": "example"
}

400

Bad Request

Media typeapplication/json

object

error

required

string

Example^generated

{
  "error": "example"
}