# Get your Meta Cloud credentials (/docs/whatsapp/meta-credentials)

> Find the four credentials OmniDimension asks for when you import a WhatsApp Cloud number, and how to set up your Meta account from scratch.

To import a WhatsApp number with the Meta Cloud API, OmniDimension asks for four values from your Meta account. This page shows you exactly where each one lives, and how to set up the Meta account from scratch if you are starting fresh.

Set aside about 20 minutes the first time. You only do this once per number.

## The four credentials [#the-four-credentials]

These are the four fields on the **WhatsApp Cloud Business** import form, and where each one comes from.

| Credential                       | What it is                                                                     | Where to find it                                                |
| -------------------------------- | ------------------------------------------------------------------------------ | --------------------------------------------------------------- |
| **WhatsApp Business Account ID** | A 15-16 digit number identifying your WhatsApp account                         | Business settings → WhatsApp accounts (or WhatsApp → API Setup) |
| **Meta App ID**                  | A 15-16 digit number identifying the app you created                           | App settings → Basic (also on API Setup)                        |
| **Meta Business ID**             | A 15-16 digit number identifying your business portfolio                       | Business settings → Business portfolio info                     |
| **Meta Access Token**            | A long string starting with `EAA…` that lets OmniDimension send on your behalf | Your system user (permanent token)                              |

  Three of the four are just ID numbers you copy. The only one that takes real setup is the access token, covered in [step 5](#create-a-system-user-and-generate-a-permanent-token). If your Meta account already has an app with WhatsApp added, skip to [Where each credential lives](#where-each-credential-lives).

## Set up Meta from scratch [#set-up-meta-from-scratch]

If you have never used the WhatsApp Cloud API before, do these five steps in order. If you already have a Meta app with WhatsApp added, jump to [step 4](#find-your-business-portfolio-id).

  
    ### Create a Meta Business portfolio [#create-a-meta-business-portfolio]

    A business portfolio (formerly "Business Manager") is the container that owns your app and WhatsApp account.

    1. Go to [business.facebook.com](https://business.facebook.com/) and sign in with your Facebook account.
    2. If you do not have one yet, open [Business settings](https://business.facebook.com/settings) and click **Create account**, then enter your business name, your name, and a work email.

    This is also where your [Meta Business ID](#find-your-business-portfolio-id) comes from later. To raise your messaging limits later, you will also complete [Meta Business verification](https://www.facebook.com/business/help/2058515294227817), but you do not need it to get your credentials or send your first test message.

    
      Meta reference: [Business portfolios](https://www.facebook.com/business/help/1710077379203657) and [Get started with the WhatsApp Cloud API](https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started?utm_source=omnidim\&utm_medium=docs).
    
  

  
    ### Create an app with WhatsApp [#create-an-app-with-whatsapp]

    1. Go to the [Meta App Dashboard](https://developers.facebook.com/apps/) and click [**Create app**](https://developers.facebook.com/apps/create/).
    2. For the use case, choose **Other**, then select the **Business** app type.
    3. Give the app a name, pick the business portfolio you just created, and click **Create app**.
    4. On the app's dashboard, find **WhatsApp** in the product list and click **Set up**.

    Meta creates a free test number and a sandbox WhatsApp Business Account for you automatically. That is enough to get your credentials and test sending.

    
      Meta reference: [Create an app](https://developers.facebook.com/docs/development/create-an-app/) and the [WhatsApp Cloud API get started guide](https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started?utm_source=omnidim\&utm_medium=docs).
    
  

  
    ### Add your own phone number (for production) [#add-your-own-phone-number-for-production]

    The test number can only message a short list of recipients you add by hand. To message real customers you add your own number:

    1. In the App Dashboard, open **WhatsApp → API Setup**.
    2. Under **Send and receive messages**, click **Add phone number**.
    3. Enter a number that is **not** already active on the WhatsApp or WhatsApp Business app, choose how to receive the verification code (SMS or call), and verify it.

    Meta walks through this in [Add a phone number](https://developers.facebook.com/docs/whatsapp/cloud-api/get-started/add-a-phone-number/?utm_source=omnidim\&utm_medium=docs), and the full registration flow is in [Register a business phone number](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration/?utm_source=omnidim\&utm_medium=docs).

    
      A number already in use on the consumer WhatsApp app or the WhatsApp Business app cannot be added directly. You either use a fresh number, or migrate the existing one off the app first. If your import later fails with "account not registered" (error `133010`), the number is still on the Business app, not the Cloud API.
    
  

  
    ### Find your business portfolio ID [#find-your-business-portfolio-id]

    This is the value OmniDimension calls **Meta Business ID**.

    1. Go to [Settings](https://business.facebook.com/latest/settings/) in Meta Business Suite.
    2. Select **Business portfolio info** from the left menu.
    3. Below your business portfolio name, you'll find your **business portfolio ID** number. Copy it.

    Older accounts may label this "Business Manager ID." It is the same number.
  

  
    ### Create a system user and generate a permanent token [#create-a-system-user-and-generate-a-permanent-token]

    The temporary token in **API Setup** expires quickly and is not suitable for production. Create a **system user** and generate a permanent token instead.

    1. Navigate to [Business settings](https://business.facebook.com/latest/settings) and click **System users** in the sidebar.
    2. Click the **Add** button in the upper-right corner and follow the prompts to create a new system user.
    3. Select the new system user and click **Assign assets**:
       * Select your **app** and toggle **Manage app** under Full control.
       * Select your **WhatsApp account** and toggle **Manage WhatsApp Business accounts** under Full control.
       * Click **Assign assets**.
    4. Click **Generate token**, then:
       * Follow the prompts to generate your token.
       * Add these permissions: [`business_management`](https://developers.facebook.com/docs/permissions#b), [`whatsapp_business_messaging`](https://developers.facebook.com/docs/permissions#w), and [`whatsapp_business_management`](https://developers.facebook.com/docs/permissions#w).
       * Copy the token and store it somewhere secure. Meta shows it only once.

    
      The `whatsapp_business_*` permissions are required. Without them the token connects but cannot send, and the import will fail. The token is a password for your WhatsApp account, so treat it like one.
    

    Meta documents this exact flow in [step 5 of the WhatsApp get started guide](https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started#step-5-create-a-system-user-and-generate-a-permanent-access-token?utm_source=omnidim\&utm_medium=docs), with more detail in [Install apps, generate, refresh, and revoke tokens](https://developers.facebook.com/docs/business-management-apis/system-users/install-apps-and-generate-tokens/?utm_source=omnidim\&utm_medium=docs).
  

## Where each credential lives [#where-each-credential-lives]

Once your app and WhatsApp account exist, here is the fastest path to each value.

### WhatsApp Business Account ID [#whatsapp-business-account-id]

In [Meta Business settings](https://business.facebook.com/latest/settings/profiles):

1. Open **Settings** from the menu on the left.
2. Under the **Accounts** dropdown, select **WhatsApp accounts**.
3. From the list on the right, click the WhatsApp Business Account you want.
4. The WABA name and the **WhatsApp Business Account ID** are shown at the top.

You can also read it in the App Dashboard under **WhatsApp → API Setup**. Twilio has a clear visual walkthrough of the Business settings path in [Locating your WhatsApp Business Account (WABA) ID](https://help.twilio.com/articles/34240818556315).

### Meta App ID [#meta-app-id]

Open **App settings → Basic** in the [App Dashboard](https://developers.facebook.com/apps/). The App ID is at the top of the page (and is also shown on WhatsApp → API Setup). The **App secret** is on the same screen behind a **Show** button. You only need the App secret if you later let OmniDimension activate inbound replies for you, covered in [Inbound replies](/docs/whatsapp/inbound-replies).

### Meta Business ID [#meta-business-id]

Your **business portfolio ID**, from [Business settings → Business portfolio info](https://business.facebook.com/latest/settings/). See [step 4](#find-your-business-portfolio-id) above.

### Meta Access Token [#meta-access-token]

Use the permanent system user token from [step 5](#create-a-system-user-and-generate-a-permanent-token). The temporary token on API Setup works for a quick test, but it expires quickly and the number will stop sending.

  The **Phone number ID** you see on the API Setup screen is handled automatically by OmniDimension when it fetches your numbers, so you do not need to copy it.

## Before you import: a quick checklist [#before-you-import-a-quick-checklist]

You are ready to import once you have all four values copied somewhere safe:

* WhatsApp Business Account ID (Business settings → WhatsApp accounts, or WhatsApp → API Setup)
* Meta App ID (App settings → Basic)
* Meta Business ID (Business settings → Business portfolio info)
* A permanent Meta Access Token (from your system user)

Next, head to [Import your WhatsApp Cloud number](/docs/whatsapp/import-number) to paste them into OmniDimension.

## Official Meta references [#official-meta-references]

Every screen above lives in Meta's own tools. These are the authoritative pages from Meta:

* [WhatsApp Cloud API: get started](https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started?utm_source=omnidim\&utm_medium=docs)
* [Meta App Dashboard](https://developers.facebook.com/apps/) and [Create an app](https://developers.facebook.com/docs/development/create-an-app/)
* [Add a phone number](https://developers.facebook.com/docs/whatsapp/cloud-api/get-started/add-a-phone-number/?utm_source=omnidim\&utm_medium=docs) and [Register a business phone number](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration/?utm_source=omnidim\&utm_medium=docs)
* [Business settings → Business portfolio info](https://business.facebook.com/latest/settings/) and [System users](https://business.facebook.com/latest/settings)
* [Step 5: create a system user and generate a permanent access token](https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started#step-5-create-a-system-user-and-generate-a-permanent-access-token?utm_source=omnidim\&utm_medium=docs)
* [System user tokens: install apps, generate, refresh, revoke](https://developers.facebook.com/docs/business-management-apis/system-users/install-apps-and-generate-tokens/?utm_source=omnidim\&utm_medium=docs) and the [permissions reference](https://developers.facebook.com/docs/permissions)
* [WhatsApp access tokens guide](https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens/?utm_source=omnidim\&utm_medium=docs)
* [Find your WhatsApp Business Account (WABA) ID](https://help.twilio.com/articles/34240818556315)
* [Meta Business verification](https://www.facebook.com/business/help/2058515294227817)

## Getting help [#getting-help]

* [Import your WhatsApp Cloud number](/docs/whatsapp/import-number)
* [OmniDimension Discord](https://discord.gg/kdjzykMTHJ)
* [OmniDimension Support](mailto:support@omnidim.io)