Skip to Content

product.received

A new product is in our intake, whether you sent it or your CharpstAR team added it. data: What we stored: articleId, name, category, subcategory, dimensionsCm, productLink, status and receivedAt.

Header Parameters

CharpstAR-Event*string
CharpstAR-Delivery*string

The delivery id; the same on every retry.

Formatuuid
CharpstAR-Signature*string

t=,v1=<hex HMAC SHA-256 of t + '.' + raw body, keyed with your whsec_ secret>

User-Agent*string

Request Body

application/json
  1. body
id*string

The delivery id; the same as the CharpstAR-Delivery header and the same on every retry.

Formatuuid
type*string
occurredAt*string

When it happened on our side.

Formatdate-time
client*

The company the key belongs to.

article*|

The article number the event is about, or null when the event is not about one product.

data*

Response Body

Any 2xx within 10 seconds means handled. Anything else is retried.

Example Requests
POST/product.received
Request Body
application/json
{  "id": "3c9e1f20-7b6a-4d5c-8e9f-0a1b2c3d4e5f",  "type": "product.received",  "occurredAt": "2026-10-20T09:31:00.000Z",  "client": {    "id": "e2b7c1d4-5a6f-4b8c-9d0e-1f2a3b4c5d6e",    "name": "Your Company"  },  "article": "CH-1001",  "data": {    "articleId": "CH-1001",    "name": "Oslo lounge chair",    "category": "Furniture",    "subcategory": "Chairs",    "dimensionsCm": {      "w": 72,      "h": 81,      "d": 78    },    "productLink": "https://example.com/products/oslo-lounge-chair",    "status": "received",    "receivedAt": "2026-10-20T09:30:58.000Z"  }}
Header Parameters
{  "CharpstAR-Event": "product.received",  "CharpstAR-Delivery": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "CharpstAR-Signature": "string",  "User-Agent": "CharpstAR-Webhooks/1"}