Matchai Docs

Set a listing’s visit hoursComing soon

Replaces the listing’s visit settings.

Coming soon. This is documented ahead of launch so you can plan your integration; it is not available yet.
PUT
/listings/{listing_id}/availability

Coming soon. Replaces the listing’s visit settings.

Scopes: calendar:write and listings:write

Pricing: Included with the connection.

Authorization

headerAuthorizationBearer <matchai_<base62>>

A personal API key, sent as Authorization: Bearer matchai_…. Create keys in Matchai under Settings → Connectors → Advanced (for developers). A key starts with matchai_ followed by letters and digits, carries the scopes chosen when it was created, and can be revoked at any time. Keys reach only the account that created them: to serve other professionals, use Connect with Matchai.

Scope: calendar:write, listings:write

Path Parameters

listing_id*string

Listing id, or its slug.

Length1 <= length <= 200

Request Body

application/json
  1. body

When visitors can book a visit of this listing. It narrows your own availability; it never widens it.

enabled*boolean

Whether visits can be booked from the listing page.

durations_minutes*array<>

Visit lengths a visitor can choose.

Items1 <= items <= 6
weekly_hours*array<>

Showing hours. Empty means "whenever I am available".

Response Body

Visit settings.

application/json
  1. response

When visitors can book a visit of this listing. It narrows your own availability; it never widens it.

enabled*boolean

Whether visits can be booked from the listing page.

durations_minutes*array<>

Visit lengths a visitor can choose.

Items1 <= items <= 6
weekly_hours*array<>

Showing hours. Empty means "whenever I am available".

Example Request
curl -X PUT 'https://api.matchai.co/v1/listings/string/availability' \  -H 'Content-Type: application/json' \  -d '{  "enabled": true,  "durations_minutes": [    5  ],  "weekly_hours": [    {      "day": "monday",      "start": "string",      "end": "string"    }  ]}'
Example Response
{  "enabled": true,  "durations_minutes": [    5  ],  "weekly_hours": [    {      "day": "monday",      "start": "string",      "end": "string"    }  ]}