Skip to content

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 the business_management scope 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:

  1. Accounts the user has direct access to
  2. Accounts accessible through linked Business Manager accounts

Ad Account Fields ​

FieldTypeDescription
idstringUnique account identifier (e.g. act_123456789)
namestringAd account name
account_idstringNumeric account ID (without the act_ prefix)
currencystringAccount currency in ISO 4217 format (e.g. USD, EUR, RUB)
timezone_namestringAccount time zone (e.g. Europe/Moscow)
account_statusintegerAccount status: 1 = active, 2 = disabled, 3 = unconfirmed
business_namestringBusiness Manager name (if applicable)
amount_spentstringAmount spent in the account currency
balancestringAccount balance
min_campaign_group_spend_capstringMinimum spend cap
ownerstringAccount 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 Account

The /{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

Maintained by the LightLead Documentation Team · Last verified: 2026-07-25