Widget enquiry

POST

/public/v1/enquiries

curl --request POST \
  --url https://example.kwickbooking.com/public/v1/enquiries \
  --header 'Content-Type: application/json' \
  --header 'X-KB-Publishable-Key: <X-KB-Publishable-Key>' \
  --data '{ "venueId": "01920000-0000-7000-8000-000000000001", "guestType": "Individual", "name": "Alex Brown", "email": "alex@example.com", "phone": null, "subject": "Private hire", "message": "Upstairs room for 40?", "sourceUrl": null, "captchaToken": "…" }'

• Your deployment

Sends an enquiry from the widget’s form to the venue’s team. Send an Idempotency-Key header.

Authorizations

• PublishableKey

Request Body^required

Media typeapplication/json

An enquiry from the widget’s form.

object

venueId

required

string format: uuid

guestType

required

string

name

required

string

email

required

null | string

phone

required

null | string

subject

required

string

message

required

string

sourceUrl

required

null | string

captchaToken

required

null | string

Example

{
  "venueId": "01920000-0000-7000-8000-000000000001",
  "guestType": "Individual",
  "name": "Alex Brown",
  "email": "alex@example.com",
  "phone": null,
  "subject": "Private hire",
  "message": "Upstairs room for 40?",
  "sourceUrl": null,
  "captchaToken": "…"
}

Responses

201

Created

Media typeapplication/json

The enquiry raised from the widget’s form (it never says whether the guest was already known).

object

enquiryId

required

string format: uuid

Example

{
  "enquiryId": "01920000-0000-7000-8000-000000000008"
}

400

Validation failed (https://developers.kwickblocks.ai/problems/validation-failed); Idempotency-Key required (https://developers.kwickblocks.ai/problems/idempotency-key-required)

Media typeapplication/problem+json

RFC 9457 problem details. type is a URI with a page describing the problem.

object

type

required

string format: uri

title

required

string

status

required

integer format: int32

detail

required

Safe to read to a guest.

string

instance

string

traceId

string

code

A machine-readable code on the widget’s routes.

string

Examples

Validation failed

{
  "type": "https://developers.kwickblocks.ai/problems/validation-failed",
  "title": "Validation failed",
  "status": 400,
  "detail": "Some of the details weren't valid. Please check them and try again."
}

Idempotency-Key required

{
  "type": "https://developers.kwickblocks.ai/problems/idempotency-key-required",
  "title": "Idempotency-Key required",
  "status": 400,
  "detail": "This request needs an Idempotency-Key header."
}

401

Invalid or missing integration key (https://developers.kwickblocks.ai/problems/invalid-key)

Media typeapplication/problem+json

RFC 9457 problem details. type is a URI with a page describing the problem.

object

type

required

string format: uri

title

required

string

status

required

integer format: int32

detail

required

Safe to read to a guest.

string

instance

string

traceId

string

code

A machine-readable code on the widget’s routes.

string

Examples

Exampleinvalid-key

Invalid or missing integration key

{
  "type": "https://developers.kwickblocks.ai/problems/invalid-key",
  "title": "Invalid or missing integration key",
  "status": 401,
  "detail": "This integration key isn't valid. Ask the venue's admin for a new one."
}

404

Not found (https://developers.kwickblocks.ai/problems/not-found)

Media typeapplication/problem+json

RFC 9457 problem details. type is a URI with a page describing the problem.

object

type

required

string format: uri

title

required

string

status

required

integer format: int32

detail

required

Safe to read to a guest.

string

instance

string

traceId

string

code

A machine-readable code on the widget’s routes.

string

Examples

Examplenot-found

Not found

{
  "type": "https://developers.kwickblocks.ai/problems/not-found",
  "title": "Not found",
  "status": 404,
  "detail": "I couldn't find that."
}

409

Idempotency-Key conflict (https://developers.kwickblocks.ai/problems/idempotency-conflict)

Media typeapplication/problem+json

RFC 9457 problem details. type is a URI with a page describing the problem.

object

type

required

string format: uri

title

required

string

status

required

integer format: int32

detail

required

Safe to read to a guest.

string

instance

string

traceId

string

code

A machine-readable code on the widget’s routes.

string

Examples

Exampleidempotency-conflict

Idempotency-Key conflict

{
  "type": "https://developers.kwickblocks.ai/problems/idempotency-conflict",
  "title": "Idempotency-Key conflict",
  "status": 409,
  "detail": "That Idempotency-Key was already used for a different request."
}

429

Too many requests (https://developers.kwickblocks.ai/problems/rate-limited)

Media typeapplication/problem+json

RFC 9457 problem details. type is a URI with a page describing the problem.

object

type

required

string format: uri

title

required

string

status

required

integer format: int32

detail

required

Safe to read to a guest.

string

instance

string

traceId

string

code

A machine-readable code on the widget’s routes.

string

Examples

Examplerate-limited

Too many requests

{
  "type": "https://developers.kwickblocks.ai/problems/rate-limited",
  "title": "Too many requests",
  "status": 429,
  "detail": "There have been too many requests. Please try again in a minute."
}