Setting Up WhatsApp Business Cloud Credentials in n8n
To connect WhatsApp Business Cloud features in n8n, you will need specific credentials that authorize two different node types:
- WhatsApp Business Cloud node
- WhatsApp Trigger node
What You'll Need Before Getting Started
To create these credentials, make sure you have access to the following Meta platforms and tools:
1. A Meta Developer Profile
This is needed to manage apps and link WhatsApp services.
How to create one:
- Go to the Facebook Developers portal
- Click Getting Started in the top right corner. If it says My Apps, your developer account is already active
- Agree to the platform's terms
- Provide a valid phone number for account verification
- Choose your professional role or area of work
2. A Verified Meta Business Portfolio
WhatsApp tools require a business portfolio, previously called Business Manager. Depending on the interface, you may see either term.
To create one:
- Head over to the Facebook Business portal
- Click Create an account
- If you already manage a business account but need an additional portfolio, open the left menu, choose the portfolio dropdown, and click Create a business portfolio
- Provide a name, your full name, and a business email
- Submit the form to complete the setup
3. A Meta App Linked to WhatsApp
Once you've created your developer profile and business portfolio, the next step is to build a Meta app and attach WhatsApp to it.
Steps to follow:
- Navigate to the Apps dashboard on the Meta for Developers site
- Click Create App
- In the product list, find WhatsApp and click Set up
- This takes you to the WhatsApp Quickstart page. Choose your business portfolio and continue
- Under App Settings, go to the Basic section
- Provide URLs for your privacy policy and terms of service
- Change the app mode from development to live
Authentication Options for WhatsApp Nodes
There are two ways to authenticate:
- Option 1: API Key (for the WhatsApp Business Cloud node)
- Option 2: OAuth2 (for the WhatsApp Trigger node)
Option 1 – Authenticating with API Key
To use this method, you'll need two things:
- An access token for the API
- A WhatsApp Business Account ID
Steps to generate these:
- Go to the Meta Apps dashboard
- Choose your app
- In the left menu, select WhatsApp, then API Setup
- Click Generate access token, accept the requested permissions
- Copy the token and paste it into the Access Token field in n8n
- Copy the Business Account ID and add it to the appropriate field in n8n
If you want to test sending messages via the API, refer to Meta's Test Business Messaging on WhatsApp.
For a full app launch, additional setup is required. See Meta's Steps 5 and up under their guide for Tech Providers, and consult the App Review documentation to complete verification.
Option 2 – Authenticating with OAuth2
To use the WhatsApp Trigger node, set up OAuth2 credentials with the following details:
- Client ID
- Client Secret
How to get them:
- Go to the Meta for Developers dashboard
- Open your app
- From the side menu, go to App Settings, then Basic
- Copy the App ID and use it as the Client ID in n8n
- Copy the App Secret and enter it as the Client Secret in n8n
Just like with the API method, a full app launch requires more steps. Make sure to read Meta's full documentation for Tech Providers and go through the official App Review process for final approval.
Additional Resources
If needed, you can always refer to the WhatsApp Cloud API documentation for technical reference, usage guidelines, and advanced configuration.
Important: Meta identifies those building WhatsApp integrations as Tech Providers. Their Get Started for Tech Providers section is a valuable resource if you plan to offer this as a service or solution to clients.
Next Steps
Now that you have WhatsApp Business Cloud credentials set up in n8n, you can:
- Build automated customer service workflows
- Create order notification systems
- Implement marketing automation campaigns
- Integrate with your CRM and database systems
Ready to build a complete chatbot? Check out our guide: Build Your Own WhatsApp Chatbot with N8N