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