Webhooks

This section of the API documentation provides details on the webhooks available in our system.

Subscription Management

This page lists helper endpoints that allow you to subscribe to and unsubscribe from webhooks.

Webhook Details

Each webhook is documented separately on individual subpages, providing specific information on their payload structure. For all outgoing webhooks, the following delivery and retry logic applies:

• Retry Duration: If the endpoint is unavailable, the system will continue to retry delivery for up to 2 days.

• Retry Interval: Retries are performed hourly throughout the 48-hour window.

---

Endpoints for Subscription Management

Get Webhook Event Types

get

Rate limit: 50 requests per minute

Authorizations

APIKeyAuth

X-API-KeystringRequired

Responses

200

OK

application/json

descriptionstringRequired

eventstring · max: 255Required

400

Bad Request

application/json

401

Unauthorized

application/json

default

get

/api/v1/webhooks/types

HTTPcURLJavaScriptPython

GET /api/v1/webhooks/types HTTP/1.1
X-API-Key: YOUR_API_KEY
Accept: */*

[
  {
    "description": "text",
    "event": "text"
  }
]

Get Webhook Subscriptions

get

Rate limit: 50 requests per minute

Authorizations

APIKeyAuth

X-API-KeystringRequired

Responses

200

OK

application/json

urlstringRequired

The URL of the webhook endpoint.

idany ofOptional

integerOptional

or

nullOptional

descriptionany ofOptional

An optional description of what the webhook is used for.

string · max: 1000Optional

or

nullOptional

enabledbooleanOptional

User side activation toggle

Default: true

created_atstring · date-timeRequired

400

Bad Request

application/json

401

Unauthorized

application/json

default

get

/api/v1/webhooks/

HTTPcURLJavaScriptPython

GET /api/v1/webhooks/ HTTP/1.1
X-API-Key: YOUR_API_KEY
Accept: */*

[
  {
    "events": [
      "order.created"
    ],
    "url": "text",
    "id": 1,
    "description": "text",
    "enabled": true,
    "created_at": "2026-03-18T17:56:36.792Z"
  }
]

Post Webhook Subscription

post

Rate limit: 50 requests per minute

Authorizations

APIKeyAuth

X-API-KeystringRequired

Body

application/json

urlstring · uri · min: 1 · max: 2083RequiredExample: https://example.com

descriptionany ofOptional

stringOptional

or

nullOptional

Responses

200

OK

application/json

urlstringRequired

The URL of the webhook endpoint.

idany ofOptional

integerOptional

or

nullOptional

descriptionany ofOptional

An optional description of what the webhook is used for.

string · max: 1000Optional

or

nullOptional

enabledbooleanOptional

User side activation toggle

Default: true

created_atstring · date-timeRequired

client_secretstring · max: 255Required

400

Bad Request

application/json

401

Unauthorized

application/json

default

post

/api/v1/webhooks/

HTTPcURLJavaScriptPython

POST /api/v1/webhooks/ HTTP/1.1
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 77

{
  "events": [
    "order.created"
  ],
  "url": "https://example.com",
  "description": "text"
}

{
  "events": [
    "order.created"
  ],
  "url": "text",
  "id": 1,
  "description": "text",
  "enabled": true,
  "created_at": "2026-03-18T17:56:36.792Z",
  "client_secret": "text"
}

Get Webhook Subscription

get

Rate limit: 50 requests per minute

Authorizations

APIKeyAuth

X-API-KeystringRequired

Path parameters

subscription_idintegerRequired

Responses

200

OK

application/json

urlstringRequired

The URL of the webhook endpoint.

idany ofOptional

integerOptional

or

nullOptional

descriptionany ofOptional

An optional description of what the webhook is used for.

string · max: 1000Optional

or

nullOptional

enabledbooleanOptional

User side activation toggle

Default: true

created_atstring · date-timeRequired

400

Bad Request

application/json

401

Unauthorized

application/json

404

Not Found

application/json

default

get

/api/v1/webhooks/{subscription_id}

HTTPcURLJavaScriptPython

GET /api/v1/webhooks/{subscription_id} HTTP/1.1
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "events": [
    "order.created"
  ],
  "url": "text",
  "id": 1,
  "description": "text",
  "enabled": true,
  "created_at": "2026-03-18T17:56:36.792Z"
}

Delete Webhook Subscription

delete

Rate limit: 50 requests per minute

Authorizations

APIKeyAuth

X-API-KeystringRequired

Path parameters

subscription_idintegerRequired

Responses

204

No Content

400

Bad Request

application/json

401

Unauthorized

application/json

404

Not Found

application/json

default

delete

/api/v1/webhooks/{subscription_id}

HTTPcURLJavaScriptPython

DELETE /api/v1/webhooks/{subscription_id} HTTP/1.1
X-API-Key: YOUR_API_KEY
Accept: */*

No content

Update Webhook Subscription Patch

patch

Rate limit: 100 requests per minute

Authorizations

APIKeyAuth

X-API-KeystringRequired

Path parameters

subscription_idintegerRequired

Body

application/json

eventsany ofOptional

or

nullOptional

urlany ofOptional

string · uri · min: 1 · max: 2083OptionalExample: https://example.com

or

nullOptional

descriptionany ofOptional

stringOptional

or

nullOptional

enabledany ofOptional

booleanOptional

or

nullOptional

Responses

200

OK

application/json

urlstringRequired

The URL of the webhook endpoint.

idany ofOptional

integerOptional

or

nullOptional

descriptionany ofOptional

An optional description of what the webhook is used for.

string · max: 1000Optional

or

nullOptional

enabledbooleanOptional

User side activation toggle

Default: true

created_atstring · date-timeRequired

400

Bad Request

application/json

401

Unauthorized

application/json

404

Not Found

application/json

default

patch

/api/v1/webhooks/{subscription_id}

HTTPcURLJavaScriptPython

PATCH /api/v1/webhooks/{subscription_id} HTTP/1.1
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 92

{
  "events": [
    "order.created"
  ],
  "url": "https://example.com",
  "description": "text",
  "enabled": true
}

{
  "events": [
    "order.created"
  ],
  "url": "text",
  "id": 1,
  "description": "text",
  "enabled": true,
  "created_at": "2026-03-18T17:56:36.792Z"
}