Graph API Version

Business Adaccount

Reading

You can't perform this operation on this endpoint.

Creating

You can make a POST request to adaccount edge from the following paths:
When posting to this edge, an AdAccount will be created.

Parameters

ParameterDescription
ad_account_created_from_bm_flag
boolean

ad_account_created_from_bm_flag

currency
ISO 4217 Currency Code

The currency used for the account

Required
end_advertiser

The entity the ads will target. Must be a Facebook Page Alias, Facebook Page ID or an Facebook App ID. In absence of one, you can use NONE or UNFOUND. Note that once a value other than NONE or UNFOUND is set, it cannot be modified any more.

Required
funding_id
numeric string or integer

ID of the payment method. If the account does not have a payment method it will still be possible to create ads but these ads will get no delivery.

invoice
boolean

If business manager has Business Manager Owned Normal Credit Line on file on the FB CRM, it will attach the ad account to that credit line.

invoice_group_id
extended_credit_invoice_group ID

The ID of the invoice group this adaccount should be enrolled in

invoicing_emails
array<string>

Emails addressed where invoices will be sent.

io
boolean

If corporate channel is direct sales.

media_agency
string

The agency, this could be your own business. Must be a Facebook Page Alias, Facebook Page ID or an Facebook App ID. In absence of one, you can use NONE or UNFOUND

Required
name
string

The name of the ad account

Required
partner
string

The advertising partner for this account, if there is one. Must be a Facebook Page Alias, Facebook Page ID or an Facebook App ID. In absence of one, you can use NONE or UNFOUND.

Required
po_number
string

Purchase order number

Return Type

This endpoint supports read-after-write and will read the node represented by id in the return type.
Struct {
id: token with structure: AdAccount ID,
account_id: numeric string,
business_id: numeric string,
end_advertiser_id: string,
media_agency_id: string,
partner_id: string,
seer_ad_account_restricted_by_soft_desc_challenge: bool,
soft_desc_challenge_credential_id: string,
soft_desc_challenge_localized_auth_amount: int32,
}

Validation Rules

ErrorDescription
100Invalid parameter
3979You have exceeded the number of allowed ad accounts for your Business Manager at this time.
3980One or more of the ad accounts in your Business Manager are currently in bad standing or in review. All of your accounts must be in good standing in order to create new ad accounts.
3902There was a technical issue and your new ad account wasn't created. Please try again.
23007This credit card can't be set as your account's primary payment method, because your account is set up to be billed after your ads have delivered. This setup can't be changed. Please try a different card or payment method.
200Permissions error
1150An unknown error occurred.
294Managing advertisements requires an access token with the extended permission for ads_management
270This Ads API request is not allowed for apps with development access level (Development access is by default for all apps, please request for upgrade). Make sure that the access token belongs to a user that is both admin of the app and admin of the ad account

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.