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

  1. Create a key in the console. It is shown once and acts as your account.
  2. Call the API with it in the Authorization header.
  3. 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 payload
order.paid

Order paid

Payment for an order is confirmed.

Example payload
booking.created

New booking

A customer books an appointment.

Example payload
rental.reserved

New rental reservation

A customer reserves a rental item.

Example payload
subscriber.created

New subscriber

Someone joins your email list.

Example payload
property_enquiry.created

New property enquiry

A visitor enquires about a property listing.

Example payload
review.submitted

New product review

A customer reviews a product.

Example payload

Rather 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.