Webkio API
Build on the sites your customers already run on Webkio.
Get new orders, bookings, reservations and more pushed to your code the moment they happen, and add contacts, email subscribers and blog drafts from anywhere.
Start in three steps
- Create a key in the console. It is shown once and acts as your account.
- Call the API with it in the
Authorizationheader. - Subscribe a URL to the events you care about, and check each delivery's signature.
Both directions
You call the API
Every request carries your key. Here, the account it belongs to.
curl https://api.webkio.com/v1/me \
-H "Authorization: Bearer wk_your_key_here"
{
"success": true,
"data": {
"id": "2bsxS7dB",
"name": "Sofia Almeida",
"email": "sofia@example.com",
"timezone": "Europe/London"
}
}
Every endpoint in the reference
Webkio calls you
The moment an order is paid, a signed POST reaches your URL.
POST /your-endpoint
X-Webkio-Event: order.paid
X-Webkio-Signature: v1=5f3a...
{
"id": "order.paid_Ab12Cd",
"event": "order.paid",
"project": {
"id": "xYz12AbC",
"name": "Your Shop",
"timezone": "Europe/London"
},
"data": {
"status": "paid",
"id": "Ab12Cd",
"number": "ORD-260914-0001",
"type": "shipping",
"customer": {
"name": "Sofia Almeida",
"email": "sofia@example.com",
"phone": "+44 20 7946 0958"
},
"currency": "GBP",
"subtotal": 42.5,
"shipping": 4.95,
"tip": null,
"discount": null,
"tax": 0,
"total": 47.45,
"payment_method": "card",
"shipping_method": "Standard",
"shipping_address": {
"line1": "1 High Street",
"city": "London",
"postcode": "EC1A 1AA",
"country": "GB"
},
"coupon_code": null,
"note": null,
"scheduled_for": null,
"items": [
{
"name": "Linen apron",
"sku": "APR-01",
"quantity": 2,
"price": 21.25,
"total": 42.5
}
],
"created_at": "2026-09-14T09:30:00Z"
}
}
How to check the signature
Events you can subscribe to
order.created
New order
An order is placed in your shop. Card payments may still be pending.
Example payloadproperty_enquiry.created
New property enquiry
A visitor enquires about a property listing.
Example payloadRather not write code?
Webkio for n8n
Build n8n workflows that start the moment an order, booking or reservation comes in, and add contacts, subscribers and blog drafts to your site from any workflow.
All integrations
Ready-made connectors, your own code, and any tool that can receive a webhook.
Signed deliveries
Every webhook carries an HMAC-SHA256 signature and a timestamp, so your endpoint can prove it came from Webkio and was not replayed.
Retried for you
A failed delivery is tried again over about half an hour. Answer 410 and the webhook removes itself.
No-code friendly
Anything that can call an API or catch a webhook works, including the webhook steps in Zapier and Make. For n8n there are ready-made Webkio nodes.