Create a webhook

shop_id is required when creating via this flat endpoint. Alternatively, use POST /sellers/{seller_id}/webhooks.

POST/webhooks

Authorization

AuthorizationBearer token (JWT) · headerrequired

Query parameters

shop_idintegerrequired

Request body

requiredapplication/json

topicstringrequired

Supported topics: orders.created, orders.updated, orders.updated.closed, orders.updated.shipped, contacts.created, contacts.updated, products.created, products.updated, products.deleted

urlstringrequired

notify_originboolean

If false, does not notify the request-originating host

default: false

authobject

Show properties

typestring

default: "none"

Allowed:nonebasic

usernamestring

passwordstring

Responses

201

Webhook created

_linksHalLinks

idinteger

channel_idinteger

topicstring

urlstring

statusstring

active — receiving deliveries normally. failed_activation — the initial activation handshake failed. failed — disabled automatically after 100 consecutive non-2xx delivery responses (see error_count); can be re-enabled via PUT /webhooks/{id}/reactivate. disabled — the target URL returned 410 Gone; disabled immediately, with no retry threshold. Also reactivatable via the same endpoint.

Allowed:activefailed_activationfaileddisabled

authobject

notify_originboolean

app_idinteger

error_countinteger

last_errorstring

last_error_onstring<date-time>

created_onstring<date-time>

updated_onstring<date-time>

403

Token lacks the scope required to subscribe to this topic

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (JWT)Remember on this deviceInclude my values in samples

Parameters

shop_idquery*

Bodyapplication/json

Request body

Request

curl -X POST 'https://api.onbolder.com/v2/webhooks?shop_id=0' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "topic": "orders.created",
  "url": "https://myapp.com/webhook"
}'

const response = await fetch("https://api.onbolder.com/v2/webhooks?shop_id=0", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"topic\": \"orders.created\",\n  \"url\": \"https://myapp.com/webhook\"\n}"
});

import requests

response = requests.post(
    "https://api.onbolder.com/v2/webhooks?shop_id=0",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"topic\": \"orders.created\",\n  \"url\": \"https://myapp.com/webhook\"\n}",
)

Response

{
  "_links": {
    "property1": {
      "href": "string",
      "templated": true,
      "method": "get",
      "title": "string",
      "type": "string"
    },
    "property2": {
      "href": "string",
      "templated": true,
      "method": "get",
      "title": "string",
      "type": "string"
    }
  },
  "id": 0,
  "channel_id": 0,
  "topic": "orders.created",
  "url": "https://myapp.com/events",
  "status": "active",
  "auth": {},
  "notify_origin": true,
  "app_id": 0,
  "error_count": 0,
  "last_error": "string",
  "last_error_on": "2019-08-24T14:15:22Z",
  "created_on": "2019-08-24T14:15:22Z",
  "updated_on": "2019-08-24T14:15:22Z"
}