Use an Invoice Group

By default, the partner receives an invoice for every ad account at the end of the month. To consolidate invoices, you can create an invoice group and add ad accounts into the group up to 3 days before the invoice is sent.

Note: Each Invoice Group may contain a maximum of 10,000 ad accounts. You may need to create additional invoice groups to accommodate more than 10,000 ad accounts.

Note: Invoice groups cannot be created, edited or deleted 2 business days before and 4 business days after the end of the month.

Create an Invoice Group

curl -i -X POST \
  -d "emails=[<EMAIL_ADDRESSES>]" \
  -d "name=<GROUP_NAME>" \
  -d "access_token=<access token sanitized>" \
  "https://graph.facebook.com/<API_VERSION>/<EXTENDED_CREDIT_ID>/extended_credit_invoice_groups"

Update the Invoice Group

Change the name or email associated with an invoice group.

curl -i -X POST \
  -d "emails=[<EMAIL_ADDRESSES>]" \
  -d "name=<GROUP_NAME>" \
  -d "access_token=<access token sanitized>" \
  "https://graph.facebook.com/<API_VERSION>/<INVOICE_GROUP_ID>"

Add an Ad Account in an Invoice Group

curl -i -X POST \
  -d "ad_account_id=<AD_ACCOUNT_ID>" \
  -d "access_token=<access token sanitized>" \
  "https://graph.facebook.com/<API_VERSION>/<INVOICE_GROUP_ID>/ad_accounts"

Remove an Ad Account in an Invoice Group

curl -i -X DELETE \
  -d "ad_account_id=<AD_ACCOUNT_ID>" \
  -d "access_token=<access token sanitized>" \
   "https://graph.facebook.com/<API_VERSION>/<INVOICE_GROUP_ID>/ad_accounts"

Check the Invoice Group

curl -i -X GET \
"https://graph.facebook.com/<API_VERSION>/<AD_ACCOUNT_ID>?fields=extended_credit_invoice_group&access_token=<access token sanitized>"

Delete an Invoice Group

curl -i -X DELETE \
  -d "access_token=<access token sanitized>" \
   "https://graph.facebook.com/<API_VERSION>/<INVOICE_GROUP_ID