> ## Documentation Index
> Fetch the complete documentation index at: https://developer.chatsyncs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Meta Developer Account Setup

> How to create a Meta developer account, create a WhatsApp app with its business portfolio, and get a test phone number with a Phone Number ID.

The one-time setup process to get a Meta developer account, create a WhatsApp Business app and
its business portfolio, and obtain a test phone number — the starting point before any API
calls can be made.

## Setup steps

<Steps>
  <Step title="Sign in to the developer portal">
    Go to `developers.facebook.com` and sign in or create an account.
  </Step>

  <Step title="Create an app">
    Click **My Apps** → **Create App**.
  </Step>

  <Step title="Name the app">
    Give it an **App name** and an **App contact email**, then continue.
  </Step>

  <Step title="Select the WhatsApp use case">
    On the Use Cases step, select **Connect with customers through WhatsApp**.
  </Step>

  <Step title="Connect a business portfolio">
    The app must be attached to a business portfolio. If none exists yet, create one with a
    portfolio name and your contact info.
  </Step>

  <Step title="Review and create the app">
    On the Overview step, confirm the app details, use case, and business portfolio, then click
    **Create app**.
  </Step>

  <Step title="Customize the WhatsApp use case">
    From the app dashboard, open **Customize the Connect with customers through WhatsApp use
    case**.
  </Step>

  <Step title="Start using the API">
    Under **Quickstart**, click **Start using the API** — this opens the API Setup screen.
  </Step>

  <Step title="Find your test number and copy your IDs">
    Under "Select phone numbers" you'll see a **test number** already provided by Meta. This is
    free to use for 90 days. On the same screen you'll find your **Phone Number ID** and your
    **WhatsApp Business Account ID (WABA ID)** — copy and save both.
  </Step>
</Steps>

You now have everything you need to make your first API call.

## Walkthrough screenshots

<Frame>
  <img src="https://mintcdn.com/chatsyncs/vUvX6MCOtxusgHGw/images/meta-api/concepts/meta-developer-account-setup/step-01-my-apps.png?fit=max&auto=format&n=vUvX6MCOtxusgHGw&q=85&s=327479e39827db8a9500ede4a6faee9f" alt="My Apps screen with Create App button" width="842" height="370" data-path="images/meta-api/concepts/meta-developer-account-setup/step-01-my-apps.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/chatsyncs/vUvX6MCOtxusgHGw/images/meta-api/concepts/meta-developer-account-setup/step-02-app-details.png?fit=max&auto=format&n=vUvX6MCOtxusgHGw&q=85&s=757d85c0aa143c360ceaa64aa456fb0d" alt="Create an app — App name and App contact email fields" width="769" height="363" data-path="images/meta-api/concepts/meta-developer-account-setup/step-02-app-details.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/chatsyncs/vUvX6MCOtxusgHGw/images/meta-api/concepts/meta-developer-account-setup/step-03-select-whatsapp-usecase.png?fit=max&auto=format&n=vUvX6MCOtxusgHGw&q=85&s=78052de1d360d1791fe1991e6dd7c254" alt="Add use cases — Connect with customers through WhatsApp selected" width="771" height="357" data-path="images/meta-api/concepts/meta-developer-account-setup/step-03-select-whatsapp-usecase.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/chatsyncs/vUvX6MCOtxusgHGw/images/meta-api/concepts/meta-developer-account-setup/step-04-create-business-portfolio.png?fit=max&auto=format&n=vUvX6MCOtxusgHGw&q=85&s=055fcd1811827c79a76223524d5c0317" alt="Create a business portfolio modal with portfolio name and contact info fields" width="558" height="454" data-path="images/meta-api/concepts/meta-developer-account-setup/step-04-create-business-portfolio.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/chatsyncs/vUvX6MCOtxusgHGw/images/meta-api/concepts/meta-developer-account-setup/step-05-review-create-app.png?fit=max&auto=format&n=vUvX6MCOtxusgHGw&q=85&s=da666faaa3ac17eea6f67320f93f103c" alt="Overview step showing app details, use case, business portfolio, and Create app button" width="687" height="455" data-path="images/meta-api/concepts/meta-developer-account-setup/step-05-review-create-app.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/chatsyncs/vUvX6MCOtxusgHGw/images/meta-api/concepts/meta-developer-account-setup/step-06-customize-usecase.png?fit=max&auto=format&n=vUvX6MCOtxusgHGw&q=85&s=d9d1e9b3efd21370be15c94d98391e89" alt="App dashboard with Customize the Connect with customers through WhatsApp use case link" width="821" height="341" data-path="images/meta-api/concepts/meta-developer-account-setup/step-06-customize-usecase.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/chatsyncs/vUvX6MCOtxusgHGw/images/meta-api/concepts/meta-developer-account-setup/step-07-quickstart.png?fit=max&auto=format&n=vUvX6MCOtxusgHGw&q=85&s=3b5ceffcd49769d1f2f603a481e2dd99" alt="Quickstart screen with Start using the API button" width="773" height="317" data-path="images/meta-api/concepts/meta-developer-account-setup/step-07-quickstart.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/chatsyncs/vUvX6MCOtxusgHGw/images/meta-api/concepts/meta-developer-account-setup/step-08-phone-number-id.png?fit=max&auto=format&n=vUvX6MCOtxusgHGw&q=85&s=4642bacdf122a39a1daf87e158acf44d" alt="API Setup screen showing test number, Phone Number ID, and WhatsApp Business Account ID" width="1176" height="609" data-path="images/meta-api/concepts/meta-developer-account-setup/step-08-phone-number-id.png" />
</Frame>

## Frequently asked

<AccordionGroup>
  <Accordion title="How do I get started with the WhatsApp Cloud API?">
    Create a Meta developer account at developers.facebook.com, create a new app, select the
    WhatsApp use case, connect a business portfolio (creating one if you don't have one), and
    finish creating the app. Meta gives you a free test number automatically.
  </Accordion>

  <Accordion title="Do I need a business portfolio before creating the app?">
    No — if you don't have one yet, the app creation flow lets you create a business portfolio
    on the spot, right at the "Business" step.
  </Accordion>

  <Accordion title="Where do I find my Phone Number ID and WABA ID?">
    In the Meta developer dashboard → your app → WhatsApp → API Setup. Both IDs are shown
    next to the test number.
  </Accordion>

  <Accordion title="Is the test number free?">
    Yes. Meta provides a test number for free for 90 days. You can send free test messages to
    up to 5 verified phone numbers during that period.
  </Accordion>

  <Accordion title="Do I need a real business to set up a developer account?">
    No. A personal Meta account is enough to create a developer app and get a test number for
    learning and development.
  </Accordion>
</AccordionGroup>

## Gotchas & common mistakes

<Warning>
  * **Test number limit:** The Meta test number can only message up to 5 verified recipient
    numbers. Add recipient numbers in the API Setup screen first.
  * **90-day limit:** Test numbers are free for 90 days, then need renewal.
  * **Business portfolio verification is optional at this stage** — Meta will offer to verify the
    new portfolio immediately, but you can choose "Verify later" and still finish the rest of the
    setup.
  * **App vs account:** The Meta developer *app* is not the same as the WABA. The app is the
    developer container; the WABA is the WhatsApp business account inside it. See the
    [WhatsApp API glossary](/meta-api/concepts/whatsapp-api-glossary).
</Warning>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.