Confirm quote

Book a quote when the customer confirms it on their page

POST/v1/quotes/{quoteId}/confirm

curl -X POST 'https://www.yovamos.com/v1/quotes/qte_8fK2mQ4xN7vRjT1aZc9LpA/confirm' \
  -H 'Content-Type: application/json' \
  -d '{
  "customer": {
    "name": "Sam Rivera",
    "email": "sam@example.com"
  },
  "consent": {
    "statement": "I agree to book Haircut at The Spot Barbershop, Tue, Jan 12 · 9:00–9:45 AM PST, for $35.00."
  }
}'

{
  "id": "bkg_bk000001",
  "status": "confirmed",
  "business": {
    "id": "biz_1v8g0yh11jl8ti",
    "name": "The Spot Barbershop",
    "timezone": "America/Los_Angeles"
  },
  "service": {
    "id": "svc_1wwvyo2007ynbx",
    "name": "Haircut"
  },
  "staff": {
    "id": "stf_0ngvtdm17z44qf",
    "name": "Marcus"
  },
  "startsAt": "2027-01-12T17:00:00Z",
  "endsAt": "2027-01-12T17:45:00Z",
  "local": "Tue, Jan 12 · 9:00–9:45 AM PST",
  "durationMinutes": 45,
  "partySize": 1,
  "price": {
    "amountMinor": 3500,
    "currency": "USD",
    "display": "$35.00"
  },
  "customer": {
    "name": "Sam Rivera",
    "email": "sam@example.com"
  },
  "source": "Dots",
  "consent": {
    "statement": "I agree to book Haircut at The Spot Barbershop, Tue, Jan 12 · 9:00–9:45 AM PST, for $35.00.",
    "at": "2027-01-11T21:40:12.000Z",
    "via": "page"
  },
  "manageUrl": "https://www.yovamos.com/booking/manage?booking=bkg_bk000001",
  "createdAt": "2027-01-11T21:40:12.000Z",
  "next": [
    "Tell the customer the booking is confirmed."
  ],
  "untrusted": [
    "business.name",
    "service.name",
    "staff.name",
    "customer.name",
    "consent.statement"
  ],
  "manageToken": "mu8_4y8WOdIm_zK99LM3BBwWq8RdowYV"
}

Path parameters

quoteIdstringRequired
Short-lived quote id from create_quote (prefix qte_). Copy it exactly. It expires; request a new quote if it does.

Body

customerCustomerInputRequired
customer.namestring (up to 120 characters)Required
Full name as the customer wants it on the booking.
customer.emailstring (up to 254 characters)Required
Email address (plain ASCII, e.g. sam@example.com).
customer.phonestring
Phone number, digits with optional leading + and separators.
consentPageConsentInputRequired
consent.statementstring (up to 500 characters)Required
The exact words the customer agreed to on the page: the label of the box they ticked. It is kept as the consent record, marked as given on the page.

Responses

201
A booking: its status, time, price, the customer's consent record and what to do next.
Booking
404
No such id, or it is not visible to this key.
NotFound
409
The price is no longer the one quoted: show the new one and get a fresh yes. | The way this is confirmed (instantly or by the business) is no longer the one quoted: show the new quote and get a fresh yes. | The slot was taken or can no longer be booked: alternatives lists nearby openings. | This Idempotency-Key, or this quote, already produced a booking for a different request.
410
The quote's hold has lapsed: create a new quote.
QuoteExpired

Search documentation

Businesses

Services

Staff

Resources

Slots

Quotes

Bookings

ScheduleOperator key

System

Notes

Path parameters

Body

Responses