Marketing API
Graph API Version

Extended Credit Invoice Group

Reading

An extended credit invoice group object

Example

Graph API Explorer
GET /v21.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

Default
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

Default

Error Codes

ErrorDescription
100Invalid parameter

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
array<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
49000Cannot create, edit or delete an invoice group

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