**With Papo's REST API (https://papo.global/), you automate the creation, listing, and cancellation of scheduled messages for WhatsApp and SMS, integrating communication scheduling directly into your systems, CRMs, or automation flows — without needing to access the dashboard manually.**

The Papo platform already offers a centralized area to manage scheduled messages, but when the volume of scheduled sends is high or when you need another software to trigger the sends, the API is the way. With it, you can create reminders, follow-ups, and notifications programmatically, keeping the same control you would have in the visual interface.

## Summary of scheduled message operations via API

| Operation | What it does | When to use |
| :--- | :--- | :--- |
| Create schedule | Schedules a WhatsApp or SMS message to a contact on a specific date and time. | Schedule appointment reminders, sales follow-ups, or billing notifications from an external system. |
| List schedules | Returns all scheduled messages, with the ability to filter by status (pending, sent, canceled, failed). | Sync the send schedule with a dashboard, check pending items before creating new schedules, or audit scheduled communications. |
| Cancel schedule | Cancels a scheduled send before the trigger time. | Stop a message that is no longer relevant, such as a reminder for a canceled event or a follow-up that no longer makes sense. |

## How the integration works

The Papo API follows the REST standard and uses Bearer token authentication. All write operations (creation and cancellation) require your account's secret key, generated in the dashboard's developer area. The base URL is `https://app.papo.global/api/v1`.

To use the scheduled message features:

1. Generate a secret key in the Papo dashboard (developer/API area). Store it in a safe place — it is shown only once.
2. In each request, include the header `Authorization: Bearer {your_secret_key}`.
3. Use the specific endpoints for scheduled messages, according to the official documentation at [https://papo.global/pt/docs](https://papo.global/pt/docs). There you will find the exact paths, required parameters (such as contact ID, channel, content, date/time), and JSON payload examples.
4. To list schedules, you can apply filters by status, allowing you to query only pending or already completed sends.

The API reflects the behavior of the platform's **Scheduled Messages** module: schedules created via API appear in the dashboard listing, and any cancellation made via API updates the status immediately.

## Who this automation is for

- **Developers and IT teams** who need to integrate message scheduling into their own systems, such as ERPs, CRMs, or appointment scheduling platforms.
- **White label resellers** who want to offer their clients the ability to schedule sends via API, increasing the value of the solution.
- **Operations with a high volume of follow-ups** (sales, billing, attendance confirmation) that want to automate the creation of reminders without manual intervention.
- **Companies that use automation flows** and trigger the creation of schedules from events in other tools.

## Frequently asked questions

### Do I need to have the Scheduled Messages module active to use the API?
Yes. The API operates on the same functionality you find in the dashboard. If the module is available in your plan, the corresponding endpoints will also be accessible.

### Does the API allow scheduling messages with attachments or media?
The official documentation details the supported content types. Currently, scheduling via the platform is focused on text messages. Consult the API reference to check whether media support is available at the time of your integration.

### How do I authenticate requests?
Use your Papo account's secret key as a Bearer token in the `Authorization` header. The key is generated in the dashboard's developer area.

### Can I schedule messages for multiple contacts at once?
The API allows creating one schedule per request. For multiple contacts, you can make sequential calls. Check the documentation to see if batch endpoints exist for your use case.

### What happens if I try to cancel a message that has already been sent?
The API will return an error, because only schedules with pending status can be canceled. After the send is triggered, the message can no longer be changed.

### Where do I find the API keys?
In the Papo dashboard, go to the developer area or API settings. The secret key is shown at the time of creation; if lost, you will need to generate a new one.

## Read also

- [How to manage scheduled messages in Papo: edit, cancel, and view](/hc/papo/articles/how-to-manage-scheduled-messages-in-papo-edit-cancel-and-view)
- [How to use the Papo API to list conversations and send programmatic messages](/hc/papo/articles/how-to-use-papo-api-list-conversations-send-messages-programmatically)

---

**[Start automating your scheduled messages now →](https://chat.papo.global/app/auth/signup?papo_lp=home&utm_source=lp&utm_medium=landing&utm_campaign=home&utm_content=start-free&papo_lp_v=start-free)**

With Papo, you integrate WhatsApp, CRM, and AI in one place, at no initial cost.