**Yes, you can manage services, schedules, and appointments via API using the [Papo](https://papo.global/) Appointments module. The REST API allows you to list services, professionals, and patients, check the calendar, and create new appointments programmatically, integrating the entire booking flow into your website, app, or external system.**

The Papo Appointments module is designed to be the control center of your calendar. It organizes four pillars: the services you offer (with name, duration, and price), the professionals who perform them, each one's availability, and the appointments made. With the API, you can automate these operations without manually accessing the panel, maintaining a seamless integration between Papo and your other tools.

## Summary of Appointments operations via API

| Operation | What it does | When to use |
| :--- | :--- | :--- |
| List services | Returns the registered appointment services, with duration and price. | Sync the service catalog with your website or app so the customer sees the options in real time. |
| List professionals | Returns the list of attendants or team members who perform the services. | Display available professionals and their specialties in an external scheduling interface. |
| List patients | Returns the registered patients, with name, phone, and ID. | Check if a client already exists in the CRM before creating a new appointment or linking it to an existing record. |
| List appointments | Returns appointments filtered by status (e.g., confirmed, pending). | Audit bookings, integrate with reporting systems, or check calendar occupancy before offering new time slots. |
| Schedule an appointment | Creates a real appointment in a professional's calendar, for a specific service and patient. | Allow customers to book directly through your website or app, or automate the creation of bookings from external systems. |

## How API authentication works

All write operations in Appointments require your Papo account's secret key, sent as a Bearer token in the authorization header. The account's public key is optional, but if sent, it must match the same account as the secret key.

The API base URL is `https://app.papo.global/api/v1`. Keys are generated in the developer area of the Papo panel. The secret key is displayed only once upon creation; store it in a safe place and revoke it immediately if there is any suspicion of leakage.

## How to use it in practice

1.  Access the developer/API area in the Papo panel and generate a secret key. Also copy the account's public key.
2.  In each request, authenticate with the secret key as a Bearer token. If you want to strengthen validation, send the public key in the header indicated in the documentation.
3.  **To build the scheduling interface**, first list the available services and professionals. This way, you can dynamically populate the options on your website or app with real data from your Papo account.
4.  **To create an appointment**, call the appointment creation endpoint, sending in the JSON payload the identifiers of the service, professional, patient, and the desired date/time. The API will validate availability in the calendar configured in the Appointments module and create the commitment.
5.  Consult the official documentation at `https://papo.global/pt/docs` to get the exact paths, required parameters, and code examples. All responses are in JSON format.

The API also allows you to list existing appointments with a status filter. This is useful for building tracking dashboards, sending automatic reminders, or integrating appointment status with other systems.

## Who this integration is for

- **Clinics, medical offices, and beauty salons** that want to offer online scheduling on their own website, with real-time availability.
- **SaaS platforms and marketplaces** that need to connect service providers' calendars to an external booking system.
- **White label resellers** who create customized solutions for end clients and want to expose the Appointments module via API.
- **Companies with automated workflows** that trigger appointment creation from events in CRMs, ERPs, or automation tools.

## Frequently asked questions

### Do I need to have the Appointments module configured to use the API?
Yes. The services, professionals, and their availability must already be registered in the Papo Appointments module so that the API can list them and validate appointments.

### Does the API allow creating a new service or professional?
The API resources focus on listing existing services and professionals and scheduling appointments. To create or edit services and professionals, use the Papo panel.

### How does the API know if a time slot is free?
When sending a request to schedule an appointment, the Papo API checks the availability configured for the professional and the chosen service on that day and time. If there is a conflict, the appointment will not be created and the API will return an error.

### Can I use the API to schedule an appointment on behalf of a patient who is not yet in the CRM?
You can first use the Papo Contacts API to create the patient (with name, email, and/or phone) and then use the returned ID to create the appointment. Consult the documentation for the contact creation endpoint.

### Can Papo's AI schedule automatically via API?
Papo's Artificial Intelligence, such as Super Chat, schedules directly through the WhatsApp conversation, checking the Appointments module calendar. The API is the path for external programmatic integrations, such as an online scheduling system.

### Where can I see the exact payload format for scheduling?
In the official API documentation, at `https://papo.global/pt/docs`. There you will find authentication details, parameters, responses, and code examples for the Appointments resources.

## Read also

- [How to use the Papo API to create and update contacts in bulk](/hc/papo/articles/how-to-use-papo-api-to-create-and-update-contacts-in-bulk)
- [How to use the Papo API to create and manage tags](/hc/papo/articles/how-to-use-papo-api-create-manage-tags)

---

**[Start integrating your calendar via API →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=how-to-use-papo-api-manage-appointments-scheduling&utm_content=en)**

Sign up for Papo and get access to the REST API to automate your appointments from the first user.