Release Candidate — the API is undergoing final validation before general availability, and minor changes may still occur.
Hellomateo API Documentation
DocumentationAPI Reference
Booking Pages

List Booking Pages

GET
/v1/booking-pages

Returns a paginated list of booking pages.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

id?string

Unique identifier for the resource.

id[in]?string

Filters by any of the supplied id values.

limit?integer

Maximum number of resources to return.

Default10
Range0 <= value <= 100
page_token?string

Opaque token returned by a previous page request.

Length1 <= length

Response Body

application/json

curl -X GET "https://api.getmateo.com/v1/booking-pages"
{  "object": "list",  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string",      "status": "draft",      "link": "http://example.com"    }  ],  "next_page_url": "string",  "previous_page_url": "string"}

Get Booking Page GET

Returns the requested booking page.

Create Calendar Blocked Time POST

Creates a manual blocked time. Public partner creates remain source: manual even when external_id is provided; source: external is reserved for provider synchronization. Optional external_id values are partner-owned, trimmed, case-sensitive, immutable synchronization locators that are unique within this organisation. POST is create-only: a duplicate returns a conflict, and after an ambiguous timeout clients should GET /v1/blocked-times/by by external_id before retrying. A recurring master and every exception require distinct external_id values; create the master first, then use its returned Mateo id as the exception series_id.