Skip to main content
POST
Book a demo from the dashboard

Authorizations

Authorization
string
header
required

API key (dh_live_...) or Auth0 JWT token

Body

application/json
leadId
string<uuid>
required

Lead identifier reused for this form submission

attemptId
string<uuid>
required

Booking identifier reused when retrying the same time

fullName
string
required

Your full name

Maximum string length: 150
email
string<email>
required

Email address for the calendar invitation

Maximum string length: 254
companyUrl
string
required

Optional company website URL

Maximum string length: 2048
Pattern: ^$|https?://[^\s]+
product
string
required

Product you would like to explore

Maximum string length: 100
message
string
required

Optional context for your demo

Maximum string length: 3000
startTime
string<date-time>
required

Selected demo start time in UTC

timezone
string
required

IANA timezone for your calendar invitation

Maximum string length: 100
slotToken
string
required

Availability token for the selected time

Maximum string length: 512
attribution
object
required

Marketing attribution captured with this request

Response

OK

id
string<uuid>
required

Identifier for this booking attempt

state
enum<string>
required

Current booking state

Available options:
RECEIVED,
CREATING,
RECONCILING,
CONFIRMED,
SLOT_UNAVAILABLE,
PROVIDER_UNAVAILABLE,
NEEDS_FOLLOW_UP,
CANCELED
startTime
string<date-time>
required

Demo start time in UTC

timezone
string
required

Timezone for the calendar invitation

meetingUrl
string | null

Link to join the confirmed demo

cancelUrl
string | null

Link to cancel the confirmed demo

rescheduleUrl
string | null

Link to reschedule the confirmed demo

errorCode
string | null

Reason the booking could not be confirmed