---
title: "Add a webhook endpoint (the secret is shown once)"
method: POST
path: "/webhooks"
tags: ["Webhooks"]
---

# Add a webhook endpoint (the secret is shown once)

`POST /webhooks`

## Request

- Base URL: `https://wall.marketing/api/v1`
- URL: `https://wall.marketing/api/v1/webhooks`
- Auth: HTTP bearer

Events are POSTed as JSON with header Wall-Signature: t=<unix time>,v1=<hex HMAC-SHA256 of "<t>.<body>" with the secret>. Failed deliveries are retried for about two days. Events: booking.awaiting_approval, booking.approved, booking.in_review, booking.declined, booking.awaiting_payment, booking.payment_failed, booking.confirmed, booking.live, booking.placement_removed, booking.cancellation_requested, booking.cancelled, report.ready, quote.expired.

## Request body

- object
  - `url` string, uri, required
  - `events` string[]

## Response `201`

Created

- object

## Other responses

- `400`: Error
- `401`: Error
- `403`: Error
- `404`: Error
- `409`: Error
- `429`: Error

---

[API](https://skmtc.dev/wall/apis/wall-marketing-platform-api.md) · [All operations](https://skmtc.dev/wall/apis/wall-marketing-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wall/apis/wall-marketing-platform-api/revisions/290b284951e3?raw)