> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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. Use when a customer asks how to get started with the WhatsApp Cloud API, where to create their app, or how to find their test number and IDs in the Meta dashboard.

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
    [glossary](/meta-api/concepts/whatsapp-api-glossary).
</Warning>
