To integrate Papo (https://papo.global/) with n8n and automate processes, you can use the platform's API keys to send contact data, manage conversations, or trigger actions, and also configure webhooks in Automation Flows so that Papo notifies n8n whenever an event occurs, such as a new message or a qualified lead.
Papo offers two main ways to communicate with n8n, one of the most popular automation platforms. The first is the API, which allows n8n to make active calls to Papo (for example, to create a contact or send a message). The second is webhooks, which work in the opposite direction: Papo automatically sends information to n8n when something happens within a service flow.
| Integration Method | Direction | Main Use | How to Configure |
|---|---|---|---|
| Papo API | n8n → Papo | Send commands to Papo (create contact, send message, fetch data). | Generate a secret key in the Papo dashboard and use n8n's HTTP Request node with Bearer authentication. |
| Papo Webhook | Papo → n8n | Receive automatic notifications from Papo when an event occurs (new conversation, qualified lead). | Create a Webhook node in n8n to generate a URL and configure the "Send Webhook" action in a Papo Flow. |
How the API integration works
Papo's API is the gateway for n8n to execute actions in your account programmatically. With it, you can automate tasks such as syncing contacts with an external CRM, triggering WhatsApp messages from a trigger, or extracting lead data.
1. Generate your API keys in Papo
Go to your Papo dashboard and navigate to Settings. In the Developers or API section, you will find your Public Key (fixed) and can generate a Secret Key. Give it a descriptive name (e.g., "n8n Integration") and copy the secret key immediately — it will be displayed only once.
2. Configure the HTTP Request node in n8n
Inside a workflow in n8n, add an HTTP Request node. In the URL field, use the desired Papo API endpoint. The base URL is:
https://app.papo.global/api/v1
To authenticate, add an Authorization header with the value Bearer sk_live_YOUR_SECRET_KEY. A good initial test is to call the /me endpoint, which returns your account data:
GET https://app.papo.global/api/v1/me
Authorization: Bearer sk_live_...
3. Build your automation flow
With authentication working, you can create complete workflows. For example:
- New form lead → create contact in Papo: a Webhook node in n8n receives the form data, and an HTTP Request node calls the Papo API to create the contact.
- Fetch extracted contacts and send to a spreadsheet: n8n periodically queries the Extractor contact list and inserts them into Google Sheets.
Papo's API allows you to fetch, create, and update contacts, send WhatsApp messages, list Extractor runs, and much more. Full documentation with all endpoints is available at papo.global/pt/docs.
How the Webhooks integration works
Webhooks are ideal for reacting to events that happen within Papo in real time. You configure a Flow to trigger an automatic notification to n8n whenever a contact reaches a specific step.
1. Create a Webhook trigger in n8n
In the n8n editor, add a Webhook node as the trigger for your workflow. Choose the POST method and copy the generated production URL. This URL will be the destination for data sent by Papo.
2. Configure the "Send Webhook" action in the Papo Flow
Inside the Papo Flow editor, add the "Send Webhook" action node at the point in the journey where you want the notification to occur (for example, right after a lead answers a qualification question).
Fill in the fields:
- Webhook URL: paste the URL copied from n8n.
- HTTP Method: select
POST. - Body (Payload): build a JSON with the contact variables you want to send. Example:
{
"name": "{{contact.name}}",
"email": "{{contact.email}}",
"phone": "{{contact.phone}}",
"stage": "Qualified lead",
"source": "Welcome Flow"
}
3. Test and activate
Before publishing, test with a service URL like Webhook.site to verify that the data arrives correctly. Then replace it with the n8n URL and activate the Flow. From that moment on, every time a contact passes through this node, n8n will receive the data and can execute actions such as registering the lead in a CRM, sending an email, or updating a spreadsheet.
Who this integration is for
The connection between Papo and n8n is useful for companies that already use Papo as a WhatsApp customer service and sales hub and need to connect these processes to other systems without relying on internal development. Marketing agencies, sales teams, and support operations can, for example, automatically sync contacts between Papo and an ERP, launch segmented campaigns, or create custom dashboards.
Frequently Asked Questions (FAQ)
Do I need to know how to code to integrate Papo with n8n?
No. n8n is a visual automation tool, and configuring the API or webhook is done by filling in fields and assembling small JSON blocks. Basic knowledge of REST APIs helps, but it is not required.
What Papo actions can I automate with the API?
You can fetch, create, and update contacts, send WhatsApp messages, list contacts extracted by the Extractor, query run data, and much more. The complete list is in the official documentation.
Does the Papo webhook send data in real time?
Yes. As soon as the contact reaches the "Send Webhook" node in an active Flow, Papo immediately sends the request to the configured URL.
Can I use the API to create a contact in the CRM from a form on my website?
Yes. Simply configure a Webhook node in n8n to capture the form data and then an HTTP Request node to call the Papo API and create the contact with the received information.
Where can I find the complete Papo API documentation?
The technical documentation with all endpoints, parameters, and examples is available at papo.global/pt/docs.
Are the API and webhooks available on the free plan?
Yes, both the API and webhooks are part of the platform and can be used by any Papo account. You can start for free with the first user and test all integrations.
Read also
The first user is free, and you can already test the API and webhooks to automate your processes at no cost.