Create a webhook for a seller

POST/sellers/{seller_id}/webhooks

Authorization

AuthorizationBearer token (JWT) · headerrequired

Path parameters

seller_idintegerrequired

Request body

requiredapplication/json

topicstringrequired

Supported topics: order.created, order.updated, order.updated.closed, order.updated.shipped, customer.created, customer.updated, customer.opted_in, customer.opted_out, product.created, product.updated, product.deleted. The plural spelling (orders.created) is accepted too; either way the subscription receives the singular one. See the Webhooks section for the topic spelling and what each customer event means.

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

The topic, spelled the way this subscription receives it (see topic_style).

topic_stylestring

How the topic is spelled in the notifications this subscription receives. Subscriptions created through v2 are singular; those created before the singular spelling existed, or through v1, stay plural so their consumers are not affected.

Allowed:singularplural

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

seller_idpath*

Bodyapplication/json

Request body

Request

curl -s -X POST \
  -H "Authorization: Bearer $BOLDER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"topic":"order.created","url":"https://myapp.com/webhook"}' \
  "https://api.onbolder.com/v2/sellers/5/webhooks"

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

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

import requests

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

Response

{
  "id": 101,
  "channel_id": 5,
  "topic": "order.created",
  "topic_style": "singular",
  "url": "https://myapp.com/webhook",
  "status": "pending",
  "notify_origin": false,
  "_links": {
    "self": {
      "href": "https://api.onbolder.com/v2/webhooks/101"
    }
  }
}