---
title: "Submit a demo booking from a Clarm agent conversation"
method: POST
path: "/api/demo-booking"
tags: ["Signup"]
---

# Submit a demo booking from a Clarm agent conversation

`POST /api/demo-booking`

Submits the fields a Clarm agent collected during a booking conversation. The edge validates that a `fields` object with a well-formed email and a numeric `agentId` are present before forwarding the booking to the Clarm booking service.

## Request body

- DemoBookingRequest — A booking collected by a Clarm agent during a conversation.
  - `agentId` integer, required — Numeric identifier of the agent that collected the booking.
  - `prospect` string — Slug identifying the prospect or demo the booking came from.
  - `fields` DemoBookingFields, required — The answers the agent collected. `email` is required; other keys vary by agent.
    - `email` string, email, required — Contact email for the booking.
    - `name` string — Contact name.
    - `company` string — Company name.
  - `timestamp` string, date-time — When the booking was collected. Defaults to receipt time.

## Response `200`

The booking was accepted.

- DemoBookingResponse — Result of a demo booking submission.
  - `success` boolean — True when the booking was accepted.
  - `message` string — Human-readable result.

## Other responses

- `400` — `fields` was missing, the email was malformed, or `agentId` was not a number.
- `500` — The booking could not be processed.

---

[API](https://skmtc.dev/clarm/apis/clarm-public-api.md) · [All operations](https://skmtc.dev/clarm/apis/clarm-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clarm/clarm-public-api/revisions/ff890a5d2a91/schema)