post
https://connect.agendapro.com/v3/locations
This endpoint creates a new location for the company, optionally with its weekly opening hours.
Important Notes
name,address,email,latitudeandlongitudeare required.addressis an array of Google Maps address components, each withlong_nameandtypes.timessets the opening hours, one entry per open day. Days not listed are closed.country_idis optional: by default, the location takes the company's country.- New locations are created active.
online_bookingcannot be set on create; use the update endpoint. - The company is taken from the API key;
company_idis never accepted. - Plan limits on the number of locations are not enforced by this endpoint.
Errors Dictionary
| Status | Error | Detail | Description |
|---|---|---|---|
| 400 | invalid_body | expected_object | Request body is not a JSON object. |
| 400 | invalid_address | — | Address must be a non-empty array with long_name and types keys. |
| 400 | invalid_email | — | Email has an invalid format. |
| 400 | invalid_coordinates | — | Latitude (-90 to 90) and longitude (-180 to 180) are required. |
| 400 | invalid_timezone | — | Timezone must be a valid IANA identifier. |
| 400 | missing_country_id | — | country_id was omitted and the company has no country to default to. |
| 400 | invalid_country_id | — | The country is not one of the company's enabled countries. |
| 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 locations:write scope. |
| 422 | invalid_location_times | — | Opening hours have an invalid format, order, or duplicate days. |
| 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…
