WhatsApp Business credentials

You can use these credentials to authenticate the following nodes:

• WhatsApp
• WhatsApp Trigger

Refer to the WhatsApp documentation to get your access token and business account ID.

Prerequisites

• Create a Meta developer account.
• Create a Meta business app.
  • WhatsApp messaging services require a Meta business portfolio (formerly called a Business Manager account. The UI may still show either option). Refer to Meta's Create a business portfolio documentation for detailed instructions.

See each supported authentication method below for more detailed instructions on creating the app.

Supported authentication methods

• API key
• OAuth2

Related resources

Refer to WhatsApp's API documentation for more information about the service.

Meta classifies users who create WhatsApp business apps as Tech Providers; refer to Meta's Get Started for Tech Providers for more information.

Using API key

To configure this credential, you'll need:

• An API Access Token
• A Business Account ID

To generate an access token, create a Meta app with WhatsApp as the product. To create the app:

1. From the Meta for Developers Apps dashboard, select Create App.
2. Select Business. If you don't see that option:
   1. Select Other.
   2. For App type, select Business, then select Next.
3. Enter a name for your app.
4. Enter a contact email address.
5. Select Create app. Refer to Create a Meta app for more detail on the above steps.
6. In Add products to your app, select Set up in the WhatsApp tile. Refer to Add the WhatsApp Product for more detail.
7. This opens the WhatsApp Quickstart page. Either select an existing business portfolio or create a new one.
8. Select Continue.
9. Go to App settings > Basic.
10. Set the Privacy Policy URL and Terms of Service URL for the app.
11. Change the App Mode to Live.
12. Open the API Setup page either from the app navigation or from the Start Using API on the Quickstart page.
13. Copy the Temporary access token and add it to n8n as the Access Token.
14. Copy the WhatsApp Business Account ID and add it to n8n as the Business Account ID. Refer to Test Business Messaging on WhatsApp for more information on the above steps.

Fully verifying and launching your app will take further configuration; refer to Meta's Get Started for Tech Providers Steps 5 and for more information.

Using OAuth2

To configure this credential, you'll need:

• A Client ID
• A Client Secret

To generate both, create a Meta app with WhatsApp as the product. To create the app:

1. From the Meta for Developers Apps dashboard, select Create App.
2. Select Business. If you don't see that option:
   1. Select Other.
   2. For App type, select Business, then select Next.
3. Enter a name for your app.
4. Enter a contact email address.
5. Select Create app. Refer to Create a Meta app for more detail on the above steps.
6. In Add products to your app, select Set up in the WhatsApp tile. Refer to Add the WhatsApp Product for more detail.
7. This opens the WhatsApp Quickstart page. Either select an existing business portfolio or create a new one.
8. Select Continue.
9. Go to App settings > Basic.
10. Set the Privacy Policy URL and Terms of Service URL for the app.
11. Change the App Mode to Live.
12. Go to App settings > Basic.
13. Copy the App ID. Use this as the Client ID within the n8n credential.
14. Copy the App Secret. Use this as the Client Secret within the n8n credential.

Fully verifying and launching your app will take further configuration; refer to Meta's Get Started for Tech Providers for more information.