Webhook

Create a new webhook

post/api/v1/restaurants/{restaurant_id}/webhooks

Request

  • Base URL: https://gotable.app
  • URL: https://gotable.app/api/v1/restaurants/{restaurant_id}/webhooks
  • Auth: HTTP bearer

Path parameters

restaurant_idinteger required

Request body

namestring required
urlstring required
eventsstring[] required
enabledboolean nullable

Example request

{
  "name": "Our CRM",
  "url": "https://webhook.site/",
  "events": [
    "reservation.created",
    "reservation.confirmed"
  ]
}

Response

With a valid API token

idinteger

The unique ID of the webhook

restaurant_idinteger

The unique ID of the restaurant

namestring

Human-readable label for the webhook

urlstring uri

The HTTP(S) endpoint the webhook will POST to

eventsstring[]

Event types the webhook is subscribed to

enabledboolean

Whether the webhook is currently active

disabled_atstring datetime nullable

When the webhook was auto-disabled after a delivery exhausted all retry attempts, if applicable

last_delivered_atstring datetime nullable

The datetime of the last delivery attempt

last_response_statusinteger nullable

HTTP status code of the most recent delivery attempt

created_atstring datetime

The datetime the webhook was created

updated_atstring datetime

The datetime the webhook was last updated

secretstring nullable

HMAC-SHA256 signing secret used to sign outbound deliveries per the Standard Webhooks spec. Returned on every response. Store it server-side and use it to verify the webhook-signature header on incoming deliveries.

Example response

{
  "id": 12345,
  "restaurant_id": 12345,
  "name": "Our Webhook Endpoint",
  "url": "https://webhook.site/",
  "events": [
    "reservation.created",
    "reservation.confirmed"
  ],
  "enabled": true,
  "disabled_at": "2026-09-15T03:18:20Z",
  "last_delivered_at": "2026-09-15T05:18:20Z",
  "last_response_status": 200,
  "created_at": "2026-09-15T06:18:20+02:00",
  "updated_at": "2026-09-15T06:18:20+02:00",
  "secret": "whsec_TmAxFgv6fXQVUP2KZSphrE3yq1q2IwoC64Zypje/db4=",
  "links": [
    {
      "href": "https://gotable.app/api/v1/",
      "method": "GET",
      "rel": "next"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.