post
https://connect.agendapro.com/v3/providers
This endpoint creates a service provider (a staff member who takes bookings) in a location of the company.
Important Notes
location_idandpublic_nameare required. The location must belong to the company.online_bookingdefaults totrue.timessets the working hours, one entry per working day, each with optionalbreaks. Days not listed are days off.- Hours are not validated against the location's opening hours.
- The company is taken from the API key;
company_idis never accepted. - Plan limits on active providers are enforced by the upstream service.
Errors Dictionary
| Status | Error | Detail | Description |
|---|---|---|---|
| 400 | invalid_body | expected_object | Request body is not a JSON object. |
| 400 | missing_* | — | A required field is missing (location_id, public_name). |
| 400 | provider_time_is_not_rounded | — | A time is not rounded to 5-minute intervals. |
| 401 | unauthorized | invalid_api_key | Missing or invalid Bearer token. |
| 401 | unauthorized | api_config_inactive | API access is inactive for this company. |
| 403 | forbidden | scope_denied | API key lacks providers:write scope. |
| 422 | public_name_too_long | — | public_name exceeds 255 characters. |
| 422 | provider_time_closes_before_open | — | A closing time is not after its opening time. |
| 422 | overlapping_provider_times | — | Two time ranges overlap on the same day. |
| 429 | rate_limited | burst_limit_exceeded | Per-minute request limit exceeded. |
| 429 | rate_limited | daily_quota_exceeded | Daily request quota exceeded. |
| 502 | upstream_unavailable | connection_failed | The upstream service is unavailable. |
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
