Meta Ads Ad Accounts
An Ad Account is the primary unit for organizing advertising data in Meta Ads. Each account has a unique identifier in the format act_XXXXXXXXXX and contains its own campaigns, ad sets, ads, and statistics.
Retrieving the List of Accounts
When connecting, LightLead automatically retrieves the list of ad accounts available to the user via the Graph API:
- Endpoint:
/me/adaccounts - Additionally:
/me/businesses(when thebusiness_managementscope is present) - Fields:
id,name,account_id,currency,timezone_name,account_status
If the user has access through Business Manager, the list of accounts is formed by combining:
- Accounts the user has direct access to
- Accounts accessible through linked Business Manager accounts
Ad Account Fields
| Field | Type | Description |
|---|---|---|
id | string | Unique account identifier (e.g. act_123456789) |
name | string | Ad account name |
account_id | string | Numeric account ID (without the act_ prefix) |
currency | string | Account currency in ISO 4217 format (e.g. USD, EUR, RUB) |
timezone_name | string | Account time zone (e.g. Europe/Moscow) |
account_status | integer | Account status: 1 = active, 2 = disabled, 3 = unconfirmed |
business_name | string | Business Manager name (if applicable) |
amount_spent | string | Amount spent in the account currency |
balance | string | Account balance |
min_campaign_group_spend_cap | string | Minimum spend cap |
owner | string | Account owner |
Connection to an Instagram Business Account
A Meta Ads ad account can be linked to an Instagram Business Account. LightLead automatically determines this connection through the chain:
Ad Account → Facebook Page → Instagram Business AccountThe /{page_id}?fields=instagram_business_account endpoint is used to retrieve Instagram accounts.
Selecting an Active Account
After connecting, you can:
- Select a primary account: used by default for all data requests
- Switch between accounts: when multiple accounts are connected
- Rename the account: for easier identification in LightLead — see Renaming a Connection
Limitations
- One connector — one account: each Meta Ads connection in LightLead is tied to a single ad account
- Maximum number of accounts: limited only by Meta API quotas and your LightLead plan
- Access permissions: the user must have at least the Advertiser role to read data