Campaign Management
API Reference contents
Accounts
Campaigns
Features
Line Item Apps
Line Items
Promoted Accounts
Promoted Tweets
Scheduled Promoted Tweets
Funding Instruments
Authenticated User Access
Bidding Rules
IAB Categories
Line Item Placements
Media Creatives
Promotable Users
Reach Estimate
Recommendations
Targeting Criteria
Targeting Options
IAB Categories
Targeting Suggestions
Bidding Rules
Content Categories
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 settingsAD_MANAGER
: Full access to modify campaigns and view stats, but cannot add or remove users or change settingsCAMPAIGN_ANALYST
: Access to view campaigns and view stats, but no access to create or modify campaignsANALYST
(“Organic Analyst” on ads.twitter.com): Access to view organic analytics and audience insights, but no access to create, modify, or view campaigns
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
or
AD_MANAGER
access.
Resource URL¶
https://ads-api.twitter.com/3/accounts/:account_id/authenticated_user_access
Parameters¶
None
Example Request¶
GET https://ads-api.twitter.com/3/accounts/18ce54d4x5t/authenticated_user_access
Example Response¶
{
"data": {
"user_id": 2417045708,
"permissions": [
"ACCOUNT_ADMIN",
"TWEET_COMPOSER"
]
},
"request": {
"params": {
"account_id": "18ce54d4x5t"
}
}
}