Send an event

post

https://sync.skuu.net/webhooks/connect/{shop_slug}

Send one event, signed over the exact body bytes. The five event names are one endpoint with one envelope; data changes with the name.

A 200 ends delivery retries. On no answer or a 5xx, resend the same bytes with the same event_id, at least three times over at least fifteen minutes. Every 4xx is permanent: correct the cause and send a new event_id. Never split one order.created to stay under the 512 KiB limit.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

shop_slug

string

required

length between 1 and 128

Body Params

inventory.updated envelope.

spec_version

const

enum

required

Defaults to 1

The contract version this event was written against. "1" is the only version, so send "1". It is required so a future version can be told apart from this one without guessing.

Allowed:

event

const

enum

required

Which event this is. data must match the name: pick the name and the matching payload together.

Allowed:

event_id

string

required

length between 1 and 255

The store's unique id for this delivery. Reuse it on a retry of the same event; never reuse it for a different payload.

occurred_at

date-time

required

When the event happened. More than five minutes in the future receives 422 future_timestamp.

data

object

required

Payload of inventory.updated: one variant at one physical location.

Responses

200

Handled, including a valid duplicate, an older inventory state or a recognised echo. SKUU customer service processes a stored return.

Language

Credentials

Header

URL

Loading…

Response

Choose an example:

application/json

400Invalid UTF-8 JSON object.

401Unknown integration or missing or invalid HMAC signature.

403Capability not enabled for this shop.

404Unknown variant, order or line. Complete the catalogue import, or correct the ids, before sending a new event.

413Request body exceeds 512 KiB. Do not retry unchanged.

422Invalid schema, unknown_event, future_timestamp, unknown_location, invalid_order, invalid_fulfillment, partial_quantity or aggregate_out_of_range.

503Temporary receiver failure. Retry the identical signed event.