Apptoto Book Now API
The Book Now API from Apptoto — 1 operation(s) for book now.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/apptoto:apptoto-book-now-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: api-settings Book Now API
version: '1.0'
servers:
- url: https://api.apptoto.com
security:
- sec0: []
- sec1: []
tags:
- name: Book Now
paths:
/v1/book_now:
post:
summary: /v1/book_now
description: Use this endpoint to book an appointment using one of your Apptoto Booking Pages.
operationId: get_v1book_now
requestBody:
required: true
content:
application/x-www-form-urlencoded:
schema:
type: object
required:
- booking_page
- time
properties:
booking_page:
type: string
description: Pass the id of the booking page or the "token". The token is the url prefix. E.g. if your booking page is https://bookwithfred.apptoto.com/, then the "token" is "bookwithfred".
example: bookwithfred
time:
type: string
description: The time to book the appointment.
example: '2025-06-21T08:00:00'
appointment_type_token:
type: string
description: Only needed for multi appointment type booking pages. Will default to the first appointment type if nothing provided.
example: default
name:
type: string
description: The name of the person booking. Required if the booking page requires it.
example: George Smith
phone_number:
type: string
description: The phone number of the person booking. Required if the booking page requires it.
example: 650-898-1212
email_address:
type: string
format: email
description: The email address of the person booking. Required if the booking page requires it.
example: george@gmail.com
field_data:
type: object
description: Object with key/value pairs for the fields that the Booking Page accepts. Required if any of the fields are marked as required.
additionalProperties: true
example:
zip: '97701'
opted_into_text_messaging:
type: boolean
description: If the Booking Page has the 'Obtain consent to send text messages about appointments' option turned on, then this field is required.
opted_into_text_messaging_for_marketing:
type: boolean
description: If the Booking Page has the 'Obtain consent to send marketing text messages' option turned on, then this field is required.
responses:
'200':
description: Booking successful
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: true
booking:
type: object
properties:
id:
type: integer
description: Apptoto booking id
state:
type: string
description: Booking state. Typically "complete". May be "pending_device_update" or "pending_device_update_for_contact" for Booking Pages backed by a remote device (e.g. a SQL calendar or Exchange Connector) — in that case use /v1/bookings to fetch the final result. "failed" if the booking did not succeed.
booking_page:
type: string
description: The booking page token
appointment_type_token:
type: string
description: The appointment type token
username:
type: string
description: The Apptoto username that owns the booking page
created_at:
type: string
format: date-time
start_time:
type: string
format: date-time
end_time:
type: string
format: date-time
name:
type: string
phone:
type: string
email:
type: string
format: email
authenticated_phone:
type: boolean
authenticated_email:
type: boolean
rescheduled_at:
type: string
format: date-time
nullable: true
previous_time:
type: string
format: date-time
nullable: true
client_ip_address:
type: string
field_data:
type: object
description: The custom field values supplied at booking time
additionalProperties: true
participant:
type: object
properties:
id:
type: integer
name:
type: string
phone:
type: string
email:
type: string
format: email
event:
type: object
properties:
id:
type: integer
calendar_id:
type: integer
calendar_name:
type: string
title:
type: string
start_time:
type: string
format: date-time
end_time:
type: string
format: date-time
'400':
description: Booking failed
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: false
error:
type: string
description: Error message
example: Time not available
booking:
type: object
description: The attempted booking. May or may not be included depending on the error. When present, its state will be "failed".
additionalProperties: true
deprecated: false
security:
- sec0: []
- sec1:
- bookings:write
tags:
- Book Now
components:
securitySchemes:
sec0:
type: http
scheme: basic
sec1:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://www.apptoto.com/oauth/authorize
tokenUrl: https://api.apptoto.com/oauth/token
refreshUrl: https://api.apptoto.com/oauth/token
scopes:
calendars:read: View calendars
address_books:read: View address books
contacts:read: View contacts
contacts:write: Create, update, and delete contacts
events:read: View calendar events
events:write: Create, update, and delete events; mark event statuses
bookings:read: View booking page availability and existing bookings
bookings:write: Create bookings on booking pages
imports:read: Check the status of imports
imports:write: Upload imports (CSV / ICS / XML) that bulk-create data
lists:read: View opt-in and opt-out lists
lists:write: Modify opt-in and opt-out lists
messaging:read: View conversations and message history
messaging:send: Send SMS or email messages on the user's behalf
webhooks:read: View webhooks
webhooks:write: Create, update, and delete webhooks that send account activity to other services
x-readme-fauxas: true
x-provenance:
method: searched
source: https://apidocs.apptoto.com/reference
harvested: '2026-10-28'
tool: harvest-readme-openapi.py
note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
assembled_from:
- https://apidocs.apptoto.com/reference/import-upload.md
- https://apidocs.apptoto.com/reference/v1address_books.md
- https://apidocs.apptoto.com/reference/v1availability.md
- https://apidocs.apptoto.com/reference/v1book_now-1.md
- https://apidocs.apptoto.com/reference/v1booking_pages.md
- https://apidocs.apptoto.com/reference/v1bookings.md
- https://apidocs.apptoto.com/reference/v1calendars-1.md
- https://apidocs.apptoto.com/reference/v1contact.md
- https://apidocs.apptoto.com/reference/v1contacts-1.md
- https://apidocs.apptoto.com/reference/v1contacts-2.md
- https://apidocs.apptoto.com/reference/v1contacts-3.md
- https://apidocs.apptoto.com/reference/v1contacts.md
- https://apidocs.apptoto.com/reference/v1contactstag.md
- https://apidocs.apptoto.com/reference/v1conversation_messages.md
- https://apidocs.apptoto.com/reference/v1conversation_reply.md
- https://apidocs.apptoto.com/reference/v1conversation_templates.md
- https://apidocs.apptoto.com/reference/v1conversations.md
- https://apidocs.apptoto.com/reference/v1event.md
- https://apidocs.apptoto.com/reference/v1eventmark.md
- https://apidocs.apptoto.com/reference/v1events-1.md
- https://apidocs.apptoto.com/reference/v1events-2.md
- https://apidocs.apptoto.com/reference/v1events-3.md
- https://apidocs.apptoto.com/reference/v1events.md
- https://apidocs.apptoto.com/reference/v1eventtag.md
- https://apidocs.apptoto.com/reference/v1import.md
- https://apidocs.apptoto.com/reference/v1lists-1.md
- https://apidocs.apptoto.com/reference/v1lists-2.md
- https://apidocs.apptoto.com/reference/v1lists-3.md
- https://apidocs.apptoto.com/reference/v1lists.md
- https://apidocs.apptoto.com/reference/v1participantmark.md
- https://apidocs.apptoto.com/reference/v1participants-1.md
- https://apidocs.apptoto.com/reference/v1participants-2.md
- https://apidocs.apptoto.com/reference/v1participants-3.md
- https://apidocs.apptoto.com/reference/v1participants.md
- https://apidocs.apptoto.com/reference/v1participants_auto_messages-1.md
- https://apidocs.apptoto.com/reference/v1participants_auto_messages.md
- https://apidocs.apptoto.com/reference/v1participanttag.md
- https://apidocs.apptoto.com/reference/v1start_conversation.md
- https://apidocs.apptoto.com/reference/v1userinfo.md
- https://apidocs.apptoto.com/reference/v1webhooks-1.md
- https://apidocs.apptoto.com/reference/v1webhooks-2.md
- https://apidocs.apptoto.com/reference/v1webhooks-3.md
- https://apidocs.apptoto.com/reference/v1webhooks.md
merge:
pages: 43
deduped: 84
conflicts_kept_first: 0