Authenticated User Access

GET accounts/:account_id/authenticated_user_access

Retrieve the permissions of the currently authenticated user (access_token) as they relate to the specified ads account. These permissions match those exposed on ads.twitter.com.

Possible values include:

  • ACCOUNT_ADMIN: Full access to modify campaigns and view stats, including the ability to add or remove users and change settings
  • AD_MANAGER: Full access to modify campaigns and view stats, but cannot add or remove users or change settings
  • CREATIVE_MANAGER: Access to modify creatives and view previews, but no access to create or modify campaigns
  • CAMPAIGN_ANALYST: Access to view campaigns and view stats, but no access to create or modify campaigns
  • ANALYST ("Organic Analyst" on ads.twitter.com): Access to view organic analytics and audience insights, but no access to create, modify, or view campaigns
  • PARTNER_AUDIENCE_MANAGER: API-only access to view and modify data partner audiences, but no access to campaigns, creatives, or other audience types.

In addition, the TWEET_COMPOSER permission indicates that the authenticated user can create nullcasted (or "Promoted-only") Tweets on behalf of the advertiser. This is only available for users with ACCOUNT_ADMIN, AD_MANAGER, or CREATIVE_MANAGER access.

Resource URL

https://ads-api.twitter.com/6/accounts/:account_id/authenticated_user_access

Parameters

None

Example Request

GET https://ads-api.twitter.com/6/accounts/18ce54d4x5t/authenticated_user_access

Example Response

{
  "data": {
    "user_id": 2417045708,
    "permissions": [
      "ACCOUNT_ADMIN",
      "TWEET_COMPOSER"
    ]
  },
  "request": {
    "params": {
      "account_id": "18ce54d4x5t"
    }
  }
}