> ## Documentation Index > Fetch the complete documentation index at: https://convo.co.in/docs/llms.txt > Use this file to discover all available pages before exploring further. # Convo Businesses and Projects: Account Structure Guide > Learn how Convo organizes WhatsApp accounts into Businesses and Projects, how each Project maps to a phone number, and how to find your IDs. Convo uses a two-level hierarchy to organize your WhatsApp presence: a **Business** sits at the top and can contain multiple **Projects**, each of which maps to a single WhatsApp phone number. Understanding this structure helps you manage multi-number deployments, billing, and access controls effectively. *** ## Business A Business represents your top-level Convo account. It is the entity that owns your subscription, holds billing information, and acts as the parent for all your Projects. Key properties of a Business: * **`business_id`** — A unique identifier assigned to your Business. You use this ID when making requests through the Partner API. * **Billing currency** — All invoices and credit purchases are settled in the currency configured for your Business. * **Timezone** — The Business timezone is used for scheduling broadcasts and reporting. * **Multiple Projects** — A single Business can own many Projects, making it straightforward to manage separate WhatsApp numbers for different brands, regions, or use cases under one account. *** ## Project A Project is the operational unit in Convo. Every Project is linked to exactly one WhatsApp Business phone number and carries its own configuration, quota, and credit balance. Key properties of a Project: | Property | Description | | - | - | | `project_id` | Unique identifier for this Project. Required in all Project API calls. | | `wa_number` | The WhatsApp phone number attached to this Project (with country code, no `+`). | | `plan` | The subscription plan active on this Project (e.g., `BASIC`, `PRO`, `ENTERPRISE`). | | `subscription` | Detailed subscription object including renewal dates and features. | | `mau_quota` | Maximum number of Monthly Active Users allowed under the current plan. | | `credit_balance` | Remaining WhatsApp Conversation Credits (WCC) available for outbound conversations. | | `sandbox` | Boolean flag indicating whether the Project is in sandbox mode. | ### Project Status Values | Status | Meaning | | - | - | | `ACTIVE` | The Project is fully operational and can send and receive messages. | | `PENDING` | The Project has been created but setup or verification is incomplete. | | `SUSPENDED` | The Project has been temporarily suspended, usually due to a billing issue. | | `STOPPED` | The Project has been manually stopped. No messages can be sent or received. | | `ARCHIVED` | The Project has been archived and is no longer in active use. | > [!TIP] > > **MAU vs WCC — what's the difference?** > > * **MAU (Monthly Active User)** quota counts the number of unique contacts you engage in a given calendar month. Exceeding your MAU quota may require a plan upgrade. > * **WCC (WhatsApp Conversation Credits)** are consumed each time you open a new conversation window with a contact. WhatsApp charges per conversation (not per message), and Convo deducts the equivalent credits from your balance. *** ## WhatsApp Number Details Each Project exposes metadata about the WhatsApp Business number it manages: | Field | Description | | - | - | | `wa_display_name` | The business display name shown to your contacts in WhatsApp. | | `wa_quality_rating` | Meta's quality rating for your number: `low`, `medium`, or `high`. A low rating can restrict your messaging tier. | | `wa_messaging_tier` | Your current daily messaging limit tier (see table below). | | `wa_about` | The "About" text shown on your WhatsApp Business profile. | | `wa_display_image` | URL of the profile picture shown for your WhatsApp Business number. | ### Messaging Tiers | Tier | Daily Message Limit | | - | - | | `tier_1` | 1,000 messages per day | | `tier_2` | 10,000 messages per day | | `tier_3` | 100,000 messages per day | WhatsApp automatically upgrades your tier as you build a positive sending history. Maintaining a high quality rating accelerates this progression. *** ## Finding Your IDs ### project\_id You can locate your `project_id` in two ways: **1. From the Dashboard URL** Open the Convo dashboard and navigate to the Project you want to work with. The URL will contain your `project_id`: ```text theme={null} https://app.convo.com/projects//dashboard ``` **2. From the Settings Page** Inside your Project, go to **Settings → General**. Your `project_id` is displayed in the **Project Information** section and can be copied directly. ### business\_id Your `business_id` is available in your **Account Settings** page, accessible from the top-right user menu in the Convo dashboard. It is also returned in the response body when you authenticate via the Partner API. *** > [!NOTE] > > **Sandbox Mode** > > When a Project's `sandbox` field is `true`, the linked WhatsApp number has not yet completed Meta's verification process. In sandbox mode you can explore the API and test integrations, but outbound messages are restricted to a small set of pre-approved test numbers. Once verification is complete, `sandbox` switches to `false` and full messaging capabilities become available. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.