Marketo Engage provides a set of User Management endpoints allow you to perform CRUD operations on user records in Marketo.
Retrieve a list of all user records. Required Permissions: Access User Management Api and Access Users
OK
Unauthorized
Forbidden
Not Found
[- {
- "errors": [
- {
- "code": 0,
- "message": "string"
}
], - "apiOnly": true,
- "emailAddress": "string",
- "firstName": "string",
- "id": 0,
- "lastName": "string",
- "userid": "string"
}
]
Send an email invitation to new user. Required Permissions: Access User Management Api and Access Users
inviteUserRequest
apiOnly | boolean Whether the user is API-Only. Default is false |
emailAddress required | string [ 1 .. 2147483647 ] characters ^("?)(?:[^"])(?:[-\w.!#$%&\'*+\/=?^_`{|}~])*\... User email address |
expiresAt | string Date and time when user login expires. Must be valid ISO-8601 string. See Datetime field type description. |
firstName required | string User first name |
lastName required | string User last name |
userid | string User id in the form of an email address. If not specified, the emailAddress value is used |
reason | string Reason for user invitation |
required | Array of objects (UserRoleWorkspaceId) |
OK
Created
Unauthorized
Forbidden
Not Found
{- "apiOnly": true,
- "emailAddress": "string",
- "expiresAt": "string",
- "firstName": "string",
- "lastName": "string",
- "userid": "string",
- "reason": "string",
- "userRoleWorkspaces": [
- {
- "accessRoleId": 0,
- "workspaceId": 0
}
]
}
"string"
Retrieve list of all role records. Required Permissions: Access User Management Api and Access Users
OK
Unauthorized
Forbidden
Not Found
[- {
- "errors": [
- {
- "code": 0,
- "message": "string"
}
], - "description": "string",
- "id": 0,
- "isHidden": true,
- "isOnlyAllZones": true,
- "name": "string",
- "createdAt": "string",
- "updatedAt": "string",
- "type": "string"
}
]
Retrieve list of workspace records. Required Permissions: Access User Management Api and Access Users
OK
Unauthorized
Forbidden
Not Found
[- {
- "errors": [
- {
- "code": 0,
- "message": "string"
}
], - "currencyInfo": "string",
- "description": "string",
- "globalViz": 0,
- "id": 0,
- "name": "string",
- "createdAt": "string",
- "updatedAt": "string",
- "status": "string"
}
]
Update one or more user attributes. Required Permissions: Access User Management Api and Access Users
updateUserAttributesRequest
OK
Created
Unauthorized
Forbidden
Not Found
{- "apiOnly": true,
- "emailAddress": "string",
- "expiresAt": "yyyyMMdd'T'HH:mm:ss'.'S't'Z",
- "firstName": "string",
- "lastName": "string"
}
{- "errors": [
- {
- "code": 0,
- "message": "string"
}
], - "apiOnly": true,
- "emailAddress": "string",
- "expiresAt": "yyyy-MM-dd'T'HH:mm:ss.SSS't'Z",
- "lastLoginAt": "yyyy-MM-dd'T'HH:mm:ss.SSS't'Z",
- "failedDeviceCode": 0,
- "failedLogins": 0,
- "firstName": "string",
- "id": 0,
- "isLocked": true,
- "lastName": "string",
- "lockedReason": "string",
- "optedIn": true,
- "userRoleWorkspaces": [
- {
- "accessRoleId": 0,
- "accessRoleName": "string",
- "workspaceId": 0,
- "workspaceName": 0
}
], - "userid": "string"
}
Get roles and workspaces for a given user. Required Permissions: Access User Management Api and Access Users
OK
Unauthorized
Forbidden
Not Found
[- {
- "accessRoleId": 0,
- "accessRoleName": "string",
- "workspaceId": 0,
- "workspaceName": 0
}
]
Add roles to a user. Required Permissions: Access User Management Api and Access Users
OK
Created
Unauthorized
Forbidden
Not Found
{- "input": [
- {
- "accessRoleId": 0,
- "workspaceId": 0
}
]
}
[- {
- "accessRoleId": 0,
- "accessRoleName": "string",
- "workspaceId": 0,
- "workspaceName": 0
}
]
Delete roles from user. Required Permissions: Access User Management Api and Access Users
OK
Unauthorized
Forbidden
Not Found
{- "input": [
- {
- "accessRoleId": 0,
- "workspaceId": 0
}
]
}
[- {
- "accessRoleId": 0,
- "accessRoleName": "string",
- "workspaceId": 0,
- "workspaceName": 0
}
]
Retrieve a single user record through its Id. Required Permissions: Access User Management Api and Access Users
OK
Unauthorized
Forbidden
Not Found
{- "errors": [
- {
- "code": 0,
- "message": "string"
}
], - "apiOnly": true,
- "emailAddress": "string",
- "expiresAt": "yyyy-MM-dd'T'HH:mm:ss.SSS't'Z",
- "lastLoginAt": "yyyy-MM-dd'T'HH:mm:ss.SSS't'Z",
- "failedDeviceCode": 0,
- "failedLogins": 0,
- "firstName": "string",
- "id": 0,
- "isLocked": true,
- "lastName": "string",
- "lockedReason": "string",
- "optedIn": true,
- "userRoleWorkspaces": [
- {
- "accessRoleId": 0,
- "accessRoleName": "string",
- "workspaceId": 0,
- "workspaceName": 0
}
], - "userid": "string"
}
Retrieve a single pending user record through its Id. A pending user is a user that has not yet accepted invitation. Required Permissions: Access User Management Api and Access Users
OK
Unauthorized
Forbidden
Not Found
{- "errors": [
- {
- "code": 0,
- "message": "string"
}
], - "id": 0,
- "firstName": "string",
- "lastName": "string",
- "emailAddress": "string",
- "userid": "string",
- "subscriptionId": "string",
- "status": "pending",
- "expiresAt": "yyyy-MM-dd'T'HH:mm:ss.SSS't'Z",
- "createdAt": "yyyy-MM-dd'T'HH:mm:ss.SSS't'Z",
- "updatedAt": "yyyy-MM-dd'T'HH:mm:ss.SSS't'Z"
}