Graph API Version

    Ad Account Agencies

    Reading

    Agencies associated with ad accounts

    Example

    Graph API Explorer
    GET /v18.0/{ad-account-id}/agencies 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(
        '/{ad-account-id}/agencies',
        '{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(
        "/{ad-account-id}/agencies",
        function (response) {
          if (response && !response.error) {
            /* handle the result */
          }
        }
    );
    /* make the API call */
    new GraphRequest(
        AccessToken.getCurrentAccessToken(),
        "/{ad-account-id}/agencies",
        null,
        HttpMethod.GET,
        new GraphRequest.Callback() {
            public void onCompleted(GraphResponse response) {
                /* handle the result */
            }
        }
    ).executeAsync();
    /* make the API call */
    FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                                   initWithGraphPath:@"/{ad-account-id}/agencies"
                                          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

    Reading from this edge will return a JSON formatted result:

    { "data": [], "paging": {} }

    data

    A list of Business nodes.

    The following fields will be added to each node that is returned:

    FieldDescription
    access_requested_time
    datetime

    The creation time of the access request

    access_status
    enum

    The status of the access request

    access_updated_time
    datetime

    The update time of the access request

    permitted_tasks
    list<string>

    The permissions of tasks associated with the access request

    paging

    For more details about pagination, see the Graph API guide.

    Error Codes

    ErrorDescription
    100Invalid parameter
    200Permissions error

    Creating

    You can't perform this operation on this endpoint.

    Updating

    You can't perform this operation on this endpoint.

    Deleting

    You can dissociate a Business from an AdAccount by making a DELETE request to /act_{ad_account_id}/agencies.

    Parameters

    ParameterDescription
    business
    business ID

    SELF_EXPLANATORY

    Required

    Return Type

    Struct {
    success: bool,
    }

    Error Codes

    ErrorDescription
    100Invalid parameter
    200Permissions error
    457The session has an invalid origin