Referencia API

Create Booking

post
https://connect.agendapro.com/v3/bookings

This endpoint creates a new booking.

Important Notes

  • Requires bookings:write scope.
  • Notifications (email, SMS, WhatsApp) are disabled for bookings created via the public API.
  • The creative_source is automatically set to connect.

Errors Dictionary

StatusErrorDetailDescription
401unauthorizedinvalid_api_keyMissing or invalid Bearer token.
401unauthorizedapi_config_inactiveAPI access is inactive for this company.
403forbiddenscope_deniedAPI key lacks bookings:write scope.
429rate_limitedburst_limit_exceededPer-minute request limit exceeded.
429rate_limiteddaily_quota_exceededDaily request quota exceeded.
502upstream_unavailableThe upstream service is unavailable.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
date-time
required

Booking start time.

date-time

Booking end time. Calculated from start_time + service duration if not provided.

integer
required

Service ID.

integer
required

Service provider ID.

integer
required

Client ID.

integer
required

Location ID.

integer
required

Booking status ID. Must be a non-cancelled status.

string

Booking price. Defaults to service price if not provided.

string | null

Booking notes.

integer | null

Time resource ID. Required if the service requires a time resource.

Responses

Updated 27 days ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 27 days ago