Marketing API Version

Ad Users

List of people 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

Name Description Returns

id

User ID for person with access

string

permissions

Permissions someone has to view or update the account:

  • 1: ACCOUNT_ADMIN: modify list of people associated with the 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 account billing information
  • 7: REPORTS: run reports
  • 9, 10 - Apply to some directly managed accounts. Not currently needed for Marketing API calls

an array of int

role

The role someone has on the account.

  • 1001 = Administrator access
  • 1002 = Advertiser, or ad manager, access
  • 1003 = Analyst access
  • 1004 = Direct sales access. For limited, directly managed accounts.

int

We return an array with these fields containing one entry for each person with account access:

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

Updating

Add someone to an account by specifying user ID and role:

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

Permissions

  • ads_management permission is required.
  • You must have 'Administrator' access to the ad account to add new users

Fields

Name Description Type

uid

User ID to add to account.

string

role

Role for user, from the values listed above

int

Response

If successful

{ "success": true
}

Deleting

Remove access to an account:

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

Permissions

  • ads_management permission is required.
  • You need 'Administrator' access to the ad account to remove users

Response

On success:

{ "success": true
}