Marketing API Version

Ad User

The list of users authorized to access and manage the ad account.

act_<ad account ID>/users

Reading

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/users"

Permissions

ads_management or ads_read permission is required.

Fields

NameDescriptionReturns

id

The User ID of the user

string

permissions

The permissions that user has to view or update the account details:

  • 1: ACCOUNT_ADMIN: modify the set of users associated with the given account.
  • 2: ADMANAGER_READ: view campaigns and ads
  • 3: ADMANAGER_WRITE: manage campaigns and ads
  • 4: BILLING_READ: view account billing information
  • 5: BILLING_WRITE: modify the account billing information
  • 7: REPORTS: run reports
  • 9, 10 - These apply to some directly managed accounts and are not currently needed for any API calls in the Marketing API

an array of int

role

The role the user has on the account.

  • 1001 = Administrator access
  • 1002 = Advertiser (ad manager) access
  • 1003 = Analyst access
  • 1004 = Direct sales access (For a small number of directly managed accounts)

int

Response

An array of the fields listed above is returned, one entry for each user with access to the account:

{
  "data": [
    {
      "id": "12121111111",
      "permissions": [
        1,
        2,
        3,
        4,
        5,
        7
      ],
      "role": 1001
    }
  ]
}

Updating

Adding users to an account

You can add a user to an ad account by specifying the user ID and role to grant.

curl -X POST \
     -d "uid=123456&role=1002" \
        https://graph.facebook.com/v2.7/act_<ACCOUNT ID>/users

Permissions

  • ads_management permission is required.
  • The user making the call must have 'Administrator' access to the ad account to add new users

Fields

NameDescriptionType

uid

User ID to add to the account.

string

role

Role to grant to the user, from the values listed above

int

Response

If successful

{
  "success": true  
}

Otherwise a relevant error message will be returned.

Deleting

You can remove a user's access to an ad account using this endpoint

curl -X DELETE \
     -d "" \
        https://graph.facebook.com/v2.7/act_<ACCOUNT ID>/users/<USER ID>

Permissions

  • ads_management permission is required.
  • The user making the call must have 'Administrator' access to the ad account to remove users

Response

If successful

{
  "success": true  
}

Otherwise a relevant error message will be returned.