> For the complete documentation index, see [llms.txt](https://docs.n8n.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.n8n.io/integrations/builtin/credentials/whatsapp.md).

# WhatsApp Business Cloud credentials

Documentation for WhatsApp Business Cloud credentials. Use these credentials to authenticate with WhatsApp Business Cloud in n8n.

You can use these credentials to authenticate the following nodes:

* [WhatsApp Business Cloud](/integrations/builtin/app-nodes/n8n-nodes-base.whatsapp.md)
* [WhatsApp Trigger](/integrations/builtin/trigger-nodes/n8n-nodes-base.whatsapptrigger.md)

## Requirements <a href="#requirements" id="requirements"></a>

To create credentials for WhatsApp, you need the following Meta assets:

* A [Meta developer](https://developers.facebook.com/docs/development/register) account: A developer account allows you to create and manage Meta apps, including WhatsApp integrations.

<details>

<summary>Set up a Meta developer account</summary>

1. Visit the [Facebook Developers site](https://developers.facebook.com).
2. Click **Getting Started** in the upper-right corner (if the link says **My Apps**, you've already set up a developer account).
3. Agree to terms and conditions.
4. Provide a phone number for verification.
5. Select your occupation or role.

</details>

* A Meta [business portfolio](https://www.facebook.com/business/help/1710077379203657?id=180505742745347): WhatsApp messaging services require a Meta business portfolio, formerly called a Business Manager account. The UI may still show either option.

<details>

<summary>Set up a Meta business portfolio</summary>

1. Visit the [Facebook Business site](https://business.facebook.com).
2. Select **Create an account**.
   * If you already have a Facebook Business account and portfolio, but want a new portfolio, open the business portfolio selector in the left-side menu and select **Create a business portfolio**.
3. Enter a **Business portfolio name**.
4. Enter your **name**.
5. Enter a **business email**.
6. Select **Submit** or **Create**.

</details>

* A Meta [business app](https://developers.facebook.com/docs/development/create-an-app/) configured with WhatsApp: Once you have a developer account, you will create a Meta business app.

<details>

<summary>Set up a Meta business app with WhatsApp</summary>

1. Visit the [Meta for Developers Apps dashboard](https://developers.facebook.com/apps/)
2. Select **Create app**.
3. In **Add products to your app**, select **Set up** in the WhatsApp tile. Refer to [Add the WhatsApp Product](https://developers.facebook.com/docs/whatsapp/solution-providers/get-started-for-tech-providers#step-3--add-the-whatsapp-product) for more detail.
4. This opens the WhatsApp **Quickstart** page. Select your business portfolio.
5. Select **Continue**.
6. In the left-side menu, go to **App settings** > **Basic**.
7. Set the **Privacy Policy URL** and **Terms of Service URL** for the app.
8. Change the **App Mode** to **Live**.

</details>

## Supported authentication methods <a href="#supported-authentication-methods" id="supported-authentication-methods"></a>

* API key: Use for the [WhatsApp Business Cloud](/integrations/builtin/app-nodes/n8n-nodes-base.whatsapp.md) node.
* OAuth2: Use for the [WhatsApp Trigger](/integrations/builtin/trigger-nodes/n8n-nodes-base.whatsapptrigger.md) node.

## Related resources <a href="#related-resources" id="related-resources"></a>

Refer to [WhatsApp's API documentation](https://developers.facebook.com/docs/whatsapp/#platform-apis) 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](https://developers.facebook.com/docs/whatsapp/solution-providers/get-started-for-tech-providers) for more information.

## Using API key <a href="#using-api-key" id="using-api-key"></a>

You need WhatsApp API key credentials to use the [WhatsApp Business Cloud](/integrations/builtin/app-nodes/n8n-nodes-base.whatsapp.md) node.

To configure this credential, you'll need:

* An API **Access Token**
* A **Business Account ID**

To generate an access token, follow these steps:

1. Visit the [Meta for Developers Apps dashboard](https://developers.facebook.com/apps/).
2. Select your Meta app.
3. In the left-side menu, select **WhatsApp** > **API Setup**.
4. Select **Generate access token** and confirm the access you want to grant.
5. Copy the **Access token** and add it to n8n as the **Access Token**.
6. Copy the **WhatsApp Business Account ID** and add it to n8n as the **Business Account ID**.

Refer to [Test Business Messaging on WhatsApp](https://developers.facebook.com/docs/whatsapp/solution-providers/become-a-tech-provider-legacy-flow#step-4--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](https://developers.facebook.com/docs/whatsapp/solution-providers/become-a-tech-provider-legacy-flow#step-5--scale-your-solution) Steps 5 and beyond for more information. Refer to [App Review](https://developers.facebook.com/docs/resp-plat-initiatives/app-review) for more information on the Meta App Review process.

## Using OAuth2 <a href="#using-oauth2" id="using-oauth2"></a>

You need WhatsApp OAuth2 credentials to use the [WhatsApp Trigger](/integrations/builtin/trigger-nodes/n8n-nodes-base.whatsapptrigger.md) node.

To configure this credential, you'll need:

* A **Client ID**
* A **Client Secret**

To retrieve these items, follow these steps:

1. Visit the [Meta for Developers Apps dashboard](https://developers.facebook.com/apps/).
2. Select your Meta app.
3. In the left-side menu, select **App settings** > **Basic**.
4. Copy the **App ID** and enter it as the **Client ID** within the n8n credential.
5. 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](https://developers.facebook.com/docs/whatsapp/solution-providers/become-a-tech-provider-legacy-flow#step-5--scale-your-solution) Steps 5 and beyond for more information. Refer to [App Review](https://developers.facebook.com/docs/resp-plat-initiatives/app-review) for more information on the Meta App Review process.