Ads and Commerce
Ads and Commerce
Resources

Business Adaccount

Updated: Sep 19, 2024

Reading

You can’t perform this operation on this endpoint.

Creating

/{business_id}/adaccount

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

Parameters

Parameter Description
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
numeric string
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
timezone_id
unsigned int32
ID for the timezone. See here.
required

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,
}

Error Codes

Error Code Description
100
Invalid parameter
3979
You have exceeded the number of allowed ad accounts for your Business Manager at this time.
3980
One 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.
415
Two factor authentication required. User have to enter a code from SMS or TOTP code generator to pass 2fac. This could happen when accessing a 2fac-protected asset like a page that is owned by a 2fac-protected business manager.
3902
There was a technical issue and your new ad account wasn’t created. Please try again.
457
The session has an invalid origin
190
Invalid OAuth 2.0 Access Token
23007
This 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.

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.
Did you find this page helpful?
Thumbs up icon
Thumbs down icon