Lists all users that have access to your partner account. The users are sorted by join date, with the first user to join appearing first.
Parameters
Name
optional
Name
optionalFilters the list of users based on the provided URL-encoded string. If the provided value fully or partially matches a Firstname
, Lastname
, or Username
, the matching user object will be returned.
State
optional
State
optionalFilters the list of users based on a provided enum value.
Possible enum values |
---|
ACTIVE |
PENDING |
INVITED |
Returns
Returns a list of users that have access to your partner account based on the parameters submitted. Returns an error if an invalid enum is submitted.
Example request
curl 'https://api.impact.com/Mediapartners/<AccountSID>/Users' \
-X GET \
-u '<AccountSID>:<AuthToken>' \
-H 'Accept: application/json' \
-d 'Name=John' \
-d 'State=ACTIVE' \
-G
Example response
{
"@page": "1",
...
"Users": [
{
"Id": "I-1234567",
"FirstName": "Wile",
"LastName": "Coyote",
"Username": "WileECoyote",
"Type": "MEMBER",
"State": "ACTIVE",
"Language": "en_US",
"AccessRights": [
{
"Role": "Creative Management",
"Permissions": [
"GET_AD_HTML",
"REQUEST_CUSTOM_ADS",
"RUN_CREATIVE_REPORTS",
"APPROVE_CREATIVE_AND_DUB_HOUSE_EXPENSES",
"MANAGE_CREATIVES"
]
},
{
"Role": "Finance",
"Permissions": [
"MANAGE_FINANCIAL_SETTINGS",
"VIEW_FINANCIALS",
"RUN_FINANCIAL_TRANSACTION_REPORTS"
]
},
{
"Role": "Advertiser Management",
"Permissions": [
"APPLY_TO_CAMPAIGN",
"RUN_ACTION_AND_PERFORMANCE_REPORTS",
"REQUEST_CAP_EXTENSIONS_AND_AGREEMENT_EXCEPTIONS",
"NEGOTIATE_AGREEMENTS",
"SEND_MARKETING_MSG_TO_BRAND",
"VIEW_BRAND_INFO"
]
},
{
"Role": "Technical",
"Permissions": [
"WEBSERVICES_INTEGRATION",
"ITEM_LIST_INTEGRATIONS",
"RUN_TECHNICAL_REPORTS",
"TRACKER_AND_BRAND_URL_INTEGRATIONS",
"EVENT_CALLBACK_INTEGRATION"
]
},
{
"Role": "Account Administration",
"Permissions": [
"RUN_USAGE_REPORTS",
"MANAGE_DIRECTORY_INFO",
"MANAGE_ACCOUNT_INFO"
]
}
],
"JoinedDate": "2020-04-29T16:24:13-07:00",
"DateLastUpdated": "2020-12-09T08:34:06-08:00",
"LastUpdatedBy": "WileECoyote",
"CreatedBy": "RoadRunner",
"Uri": "/Mediapartners/IRMTQCr9awmz1924609yGQDbCui8EbfRN1/Users/I-2320266"
},
{
...
}
]
}