# AgendaPro Documentation > Documentation for AgendaPro ## Guía de uso: Guía v3 - [Primeros pasos con la API v3](https://developers.agendapro.com/docs/getting-started.md): Aprende a autenticarte, hacer tu primera consulta y manejar respuestas con la nueva API pública de AgendaPro. - [Autenticación](https://developers.agendapro.com/docs/authentication.md): Cómo autenticarse con la API v3 de AgendaPro. - [Webhooks](https://developers.agendapro.com/docs/webhooks.md): Recibe notificaciones en tiempo real cuando ocurren eventos en tu cuenta de AgendaPro. ## Referencia API: Getting Started - [Connect v3](https://developers.agendapro.com/reference/getting-started-v3.md): Referencia completa de la API pública v3 de AgendaPro. ## Referencia API: Bookings - [List Available Slots](https://developers.agendapro.com/reference/listavailableslots.md): Returns available booking slots for a service at a location on a given date. Results are grouped into a `slots` array and a `metadata` object. The `slots` array contains individual time windows;… - [List Bookings](https://developers.agendapro.com/reference/listbookings.md): This endpoint returns a paginated list of bookings for the company. ### Important Notes - Results are scoped to the company associated with the API key. - At least one entity filter is required:… - [Create Booking](https://developers.agendapro.com/reference/createbooking.md): 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… - [Get Booking](https://developers.agendapro.com/reference/getbooking.md): This endpoint returns a single booking by ID. ### Errors Dictionary | **Status** | **Error** | **Detail** | **Description** | | --- | --- | --- | --- | | 401 | unauthorized | invalid_api_key |… - [Update Booking](https://developers.agendapro.com/reference/updatebooking.md): This endpoint updates an existing booking. Only provided fields are updated (partial update). ### Customer policy enforcement Updates are validated against the merchant's customer policy before… - [Cancel Booking](https://developers.agendapro.com/reference/cancelbooking.md): This endpoint cancels a booking. ### Customer policy enforcement Cancellations are validated against the merchant's customer policy before being applied. If the merchant has disabled cancellations,… ## Referencia API: Clients - [List Clients](https://developers.agendapro.com/reference/listclients.md): This endpoint returns a paginated list of clients for the company. ### Errors Dictionary | **Status** | **Error** | **Detail** | **Description** | | --- | --- | --- | --- | | 401 | unauthorized |… - [Quick Search Clients](https://developers.agendapro.com/reference/quicksearchclients.md): This endpoint returns a small, ranked list of clients matching a free-text query. It searches by name, email, phone, identification number, and record number, and is intended for type-ahead /… - [Create Client](https://developers.agendapro.com/reference/createclient.md): This endpoint creates a new client for the company. ### Important Notes - At least one of `last_name`, `email`, or `phone` is required by business logic. - Email is normalized to lowercase. - Phone… - [Get Client](https://developers.agendapro.com/reference/getclient.md): This endpoint returns a single client by ID. ### Errors Dictionary | **Status** | **Error** | **Detail** | **Description** | | --- | --- | --- | --- | | 401 | unauthorized | invalid_api_key |… - [Update Client](https://developers.agendapro.com/reference/updateclient.md): This endpoint updates an existing client. Only provided fields are updated (partial update). ### Errors Dictionary | **Status** | **Error** | **Detail** | **Description** | | --- | --- | --- | ---… - [Deactivate Client](https://developers.agendapro.com/reference/deactivateclient.md): This endpoint deactivates (soft deletes) a client. ### Errors Dictionary | **Status** | **Error** | **Detail** | **Description** | | --- | --- | --- | --- | | 401 | unauthorized | invalid_api_key |… - [List Client Custom Attributes](https://developers.agendapro.com/reference/listclientcustomattributes.md): Returns the custom attribute values for a specific client. These are the values that fill the templates returned by `GET /v3/custom_attributes`. ### Errors Dictionary | **Status** | **Error** |… ## Referencia API: Custom Attributes - [List Custom Attribute Templates](https://developers.agendapro.com/reference/listcustomattributetemplates.md): Returns the custom attribute templates configured for the company. These define which custom attributes can be set on clients. Use template `id` values when setting `custom_attributes` on client… ## Referencia API: Locations - [List Locations](https://developers.agendapro.com/reference/listlocations.md): This endpoint returns a paginated list of locations for the company. ### Errors Dictionary | **Status** | **Error** | **Detail** | **Description** | | --- | --- | --- | --- | | 401 | unauthorized |… - [Get Location](https://developers.agendapro.com/reference/getlocation.md): This endpoint returns a single location by ID. ### Errors Dictionary | **Status** | **Error** | **Detail** | **Description** | | --- | --- | --- | --- | | 401 | unauthorized | invalid_api_key |… ## Referencia API: Services - [List Services](https://developers.agendapro.com/reference/listservices.md): This endpoint returns a paginated list of services for the company. ### Errors Dictionary | **Status** | **Error** | **Detail** | **Description** | | --- | --- | --- | --- | | 401 | unauthorized |… - [Get Service](https://developers.agendapro.com/reference/getservice.md): This endpoint returns a single service by ID. ### Errors Dictionary | **Status** | **Error** | **Detail** | **Description** | | --- | --- | --- | --- | | 401 | unauthorized | invalid_api_key |… - [List Categories](https://developers.agendapro.com/reference/listcategories.md): This endpoint returns a paginated list of service categories for the company, ordered by the `order` field ascending (ties broken by `id` ascending). ### Errors Dictionary | **Status** | **Error**… ## Referencia API: Providers - [List Providers](https://developers.agendapro.com/reference/listproviders.md): This endpoint returns a paginated list of service providers for the company. ### Errors Dictionary | **Status** | **Error** | **Detail** | **Description** | | --- | --- | --- | --- | | 401 |… - [Get Provider](https://developers.agendapro.com/reference/getprovider.md): This endpoint returns a single service provider by ID. ### Errors Dictionary | **Status** | **Error** | **Detail** | **Description** | | --- | --- | --- | --- | | 401 | unauthorized |… ## Referencia API: Products - [List Products](https://developers.agendapro.com/reference/listproducts.md): This endpoint returns a paginated list of products for the company. ### Important Notes - Internal pricing and commission data (`cost`, `internal_price`, `tax`, `has_sales_taxes`,… - [Create Product](https://developers.agendapro.com/reference/createproduct.md): This endpoint creates a new product in the company catalog. ### Important Notes - `name` and `price` are required. - New products are created active, with stock 0 at every company location. Use the… - [Get Product](https://developers.agendapro.com/reference/getproduct.md): This endpoint returns a single product by ID. ### Errors Dictionary | **Status** | **Error** | **Detail** | **Description** | | --- | --- | --- | --- | | 401 | unauthorized | invalid_api_key |… - [Update Product](https://developers.agendapro.com/reference/updateproduct.md): This endpoint updates an existing product. Only provided fields are updated (partial update). ### Important Notes - Internal pricing and commission fields cannot be updated through the public API.… - [Activate Product](https://developers.agendapro.com/reference/activateproduct.md): This endpoint sets a product to active. It takes no request body, and is idempotent. ### Errors Dictionary | **Status** | **Error** | **Detail** | **Description** | | --- | --- | --- | --- | | 401… - [Deactivate Product](https://developers.agendapro.com/reference/deactivateproduct.md): This endpoint sets a product to inactive. It takes no request body, and is idempotent. ### Errors Dictionary | **Status** | **Error** | **Detail** | **Description** | | --- | --- | --- | --- | |… ## Referencia API: Sales - [List Sales](https://developers.agendapro.com/reference/listsales.md): This endpoint returns a paginated list of sales for the company. ### Important Notes - Requires `sales:read` scope. - Sales are read-only via the public API. ### Errors Dictionary | **Status** |… - [Get Sale](https://developers.agendapro.com/reference/getsale.md): This endpoint returns a single sale by ID. ### Errors Dictionary | **Status** | **Error** | **Detail** | **Description** | | --- | --- | --- | --- | | 401 | unauthorized | invalid_api_key | Missing… ## Referencia API: Carts - [Create Cart](https://developers.agendapro.com/reference/createcart.md): Creates a shopping cart. The cart is the first step of the online payment flow: add items, then create a payment request on the cart to obtain a checkout URL. ### Important Notes - Requires… - [Get Cart](https://developers.agendapro.com/reference/getcart.md): Returns a single cart by ID. Only carts belonging to the authenticated company are visible; other carts return 404. ### Errors Dictionary | **Status** | **Error** | **Detail** | **Description** | |… - [Update Cart](https://developers.agendapro.com/reference/updatecart.md): Updates a cart's items or client. Only carts belonging to the authenticated company can be updated; other carts return 404. ### Important Notes - Requires `carts:write` scope. - Sending `items`… ## Referencia API: Payment Requests - [Create Payment Request](https://developers.agendapro.com/reference/createpaymentrequest.md): Creates an online payment request for the cart and returns a checkout URL in `params.checkout_url`. Share that URL with the end customer to collect the payment. ### Important Notes - Requires… - [Cancel Payment Request](https://developers.agendapro.com/reference/cancelpaymentrequest.md): Cancels a pending payment request. Bookings that were reserved when the payment request was created are released immediately instead of waiting for the expiration timeout. Use this when the customer…