Graph API Version

Extended Credit Invoice Group

Reading

An extended credit invoice group object

Example

Graph API Explorer
GET /v19.0/{extended-credit-invoice-group-id} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{extended-credit-invoice-group-id}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/{extended-credit-invoice-group-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{extended-credit-invoice-group-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{extended-credit-invoice-group-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
If you want to learn how to use the Graph API, read our Using Graph API guide.

Parameters

This endpoint doesn't have any parameters.

Fields

FieldDescription
id
numeric string

ID

auto_enroll
bool

Shows if the adaccount using the current credit will be enrolled into the invoice group automatically

customer_po_number
string

The customer PO number of this invoice group assigned by the customer creating or editing the group

email
ExtendedCreditEmail

The invoice email object associated with this invoice group and only allow one email address associated with one group

emails
list<string>

The invoice emails attached to the invoice group

name
string

Extended credit invoice group name assigned

Error Codes

ErrorDescription
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

Creating

You can't perform this operation on this endpoint.

Updating

You can update an ExtendedCreditInvoiceGroup by making a POST request to /{extended_credit_invoice_group_id}.

Parameters

ParameterDescription
emails
list<string>

The emails associated to the extended credit invoice group

name
string

Extended credit invoice group name assigned

Return Type

This endpoint supports read-after-write and will read the node represented by id in the return type.
Struct {
id: numeric string,
}

Error Codes

ErrorDescription
100Invalid parameter

Deleting

You can delete an ExtendedCreditInvoiceGroup by making a DELETE request to /{extended_credit_invoice_group_id}.

Parameters

This endpoint doesn't have any parameters.

Return Type

Struct {
success: bool,
}

Error Codes

ErrorDescription
100Invalid parameter
You can dissociate an ExtendedCreditInvoiceGroup from an ExtendedCreditInvoiceGroup by making a DELETE request to /{extended_credit_invoice_group_id}/ad_accounts.

Parameters

ParameterDescription
ad_account_id
string

The id of the ad account that will be removed from the invoice group

Required

Return Type

Struct {
success: bool,
}

Error Codes

ErrorDescription
49002Cannot delete the ad account from the invoice group