Skip to content

WhatsApp Business Cloud credentials#

You can use these credentials to authenticate the following nodes:

Prerequisites#

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

Supported authentication methods#

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: Generated when you create a Meta app with WhatsApp as the product.
  • A Business Account ID: Generated for all WhatsApp Business accounts. You can view yours in Business Manager > Business Settings > Accounts > WhatsApp Business Accounts and view your account details, or copy it from the Meta app you create.

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 beyond for more information. Refer to App Review for more information on the Meta App Review process.

Using OAuth2#

To configure this credential, you'll need:

  • A Client ID: Generated once you create a Meta app with WhatsApp as the product.
  • A Client Secret: Generated once you create a Meta app with WhatsApp as the product.

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 and enter it as the Client ID within the n8n credential.
  14. Copy the App Secret and enter it 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 Steps 5 and beyond for more information. Refer to App Review for more information on the Meta App Review process.