User

The individual that uses the application. See https://developers.outreach.io/api/common-patterns/#invite-new-users for more information on inviting new users.

accountsViewId
integer

The default smart view to load on the account index view.

activityNotificationsDisabled
boolean

A boolean value whether the user's activity notifications are disabled.

bounceWarningEmailEnabled
boolean

A boolean value whether the user's bounce warning emails are enabled.

bridgePhone
string <= 255 characters

The telephone number of the user's outbound bridge phone.

bridgePhoneExtension
string <= 255 characters

The extension number of the user's outbound bridge phone.

callsViewId
integer

The default smart view to load on the calls view.

controlledTabDefault
string <= 255 characters

The user's preferred default tab to open when in task flow.

createdAt
string <date-time>

The date and time the user was created.

currentSignInAt
string <date-time>

The date and time the user most recently signed in.

custom1
string <= 225 characters

The value of the user's first custom field.

custom2
string <= 225 characters

The value of the user's second custom field.

custom3
string <= 225 characters

The value of the user's third custom field.

custom4
string <= 225 characters

The value of the user's fourth custom field.

custom5
string <= 225 characters

The value of the user's fifth custom field.

dailyDigestEmailEnabled
boolean

A boolean value whether the user's daily digest emails are enabled.

defaultRulesetId
integer

The id of the default ruleset assigned to the user.

duties
object

A collection of the user's work roles.

email
string <email> <= 255 characters

The email address of the user. Cannot be updated via the API.

enableVoiceRecordings
boolean

A boolean value whether the user has voice recordings enabled.

engagementEmailsEnabled
boolean

A boolean value whether the user has engagement emails enabled.

firstName
string <= 255 characters

The first name of the user.

inboundBridgePhone
string <= 255 characters

The telephone number of the user's inbound bridge phone.

inboundBridgePhoneExtension
string <= 255 characters

The extension number of the user's inbound bridge phone.

inboundCallBehavior
string <= 255 characters

The behavior of inbound calls. Must be either "inbound_bridge" or "inbound_voicemail".

inboundPhoneType
string <= 255 characters

The user's type of telephone for inbound calls. Must be either "bridge", "voip" or "bridge_and_voip".

inboundVoicemailCustomMessageText
string <= 1024 characters

The message for inbound voicemails (e.g. "Please leave a message and I will get back to you as soon I can").

inboundVoicemailMessageTextVoice
string <= 255 characters

The gender of the voice that reads the voicemail message. Must be either "man" or "woman".

inboundVoicemailPromptType
string <= 255 characters

The type of inbound voicemail to use. Must be either "automated", "recorded", or "off".

kaiaRecordingsViewId
integer

The default smart view to load on the kaia recordings view.

keepBridgePhoneConnected
boolean

Whether to keep the user's bridge phone connected in-between outbound calls.

lastName
string <= 255 characters

The last name of the user.

lastSignInAt
string <date-time>

The date and time the user previously signed in.

locked
boolean

A boolean value whether the user is locked out of the application.

mailboxErrorEmailEnabled
boolean

A boolean value whether the user's mailbox error emails are enabled.

meetingEngagementNotificationEnabled
boolean

A boolean value whether the user's meeting engagement notifications are enabled.

name
string

The full name of the user.

notificationsEnabled
boolean

A boolean value whether the user's notifications are enabled.

oceClickToDialEverywhere
boolean

A boolean value indicating if phone calls will launch a call from Outreach (Salesforce, Github, Gmail, LinkedIn, and Twitter).

oceGmailToolbar
boolean

A boolean value indicating whether the Outreach Gmail toolbar is enabled.

oceGmailTrackingState
string <= 255 characters

The user's current email tracking settings when using Outreach Everywhere with GMail.

oceSalesforceEmailDecorating
boolean

A boolean value indicating if emails are enabled in Outreach Everywhere with Salesforce.

oceSalesforcePhoneDecorating
boolean

A boolean value indicating if phone calls are enabled in Outreach Everywhere with Salesforce.

oceUniversalTaskFlow
boolean

A boolean value indicating whether Outreach Everywhere universal task flow is enabled.

oceWindowMode
boolean

A boolean value indicating whether Outreach Everywhere window mode is enabled.

opportunitiesViewId
integer

The default smart view to load on the opportunity index view.

passwordExpiresAt
string <date-time>

The date and time the current password expires.

phoneCountryCode
string <= 2 characters

The country code of the user's phone.

phoneNumber
string

The telephone number of the user's phone.

phoneType
string <= 255 characters

The user's type of telephone for outbound calls. Must be either "bridge" or "voip".

pluginAlertNotificationEnabled
boolean

A boolean value whether the user's plugin related error notifications are enabled.

preferredVoiceRegion
string <= 255 characters

A string that represents Twilio data center used to connect to Twilio.

prefersLocalPresence
boolean

A boolean value whether the user prefers that a voice call comes from a local phone number.

primaryTimezone
string <= 255 characters

The primary preferred timezone to use when scheduling meetings.

prospectsViewId
integer

The default smart view to load on the prospect index view.

reportsTeamPerfViewId
integer

The default smart view to load on the team performance reports view.

reportsViewId
integer

The default smart view to load on the reports view.

scimExternalId
string <= 255 characters

The ID from the SCIM provisioning service used to create the user.

scimSource
string <= 255 characters

The name of the SCIM provisioning source used to create the user.

secondaryTimezone
string <= 255 characters

The secondary preferred timezone to use when scheduling meetings.

senderNotificationsExcluded
boolean

A boolean value whether the user's sender notifications are excluded.

tasksViewId
integer

The default smart view to load on the tasks index view.

teamsViewId
integer

The default smart view to load on the teams index view.

tertiaryTimezone
string <= 255 characters

The tertiary preferred timezone to use when scheduling meetings.

textingEmailNotifications
boolean

A boolean value whether to send the user email notifications when a text message is missed.

title
string <= 255 characters

The user's job title (e.g. "Staff Accountant").

unknownReplyEmailEnabled
boolean

A boolean value whether the user's unknown reply emails are enabled.

updatedAt
string <date-time>

The date and time the user was last updated.

userGuid
string

The globally unique ID (GUID) assigned to the user.

username
string <= 255 characters

A reader friendly unique identifier of the user.

usersViewId
integer

The default smart view to load on the users index view.

voicemailNotificationEnabled
boolean

A boolean value whether the user's voicemail notifications are enabled.

weeklyDigestEmailEnabled
boolean

A boolean value whether the user's weekly digest email are enabled.

{
}

User Relationships

Array of links (object) (batch)
Array of data (object) or links (object) (contentCategory)

The groupings of sequences, snippets and templates that this user has access to. Relationship contentCategories cannot be used as a filter.

(user (data (object) or links (object)))

The creator of the user. Relationship creator cannot be used as a filter.

data (object) or links (object) (mailbox)

The default mailbox associated with the user. Relationship mailbox cannot be used as a filter.

Array of data (object) or links (object) (mailbox)

All mailboxes associated with the user. Relationship mailboxes cannot be used as a filter.

data (object) or links (object) (profile)

The user's profile in Outreach. You can use only the attribute id to filter users by profile (e.g. filter[profile][id]=X).

Array of data (object) or links (object) (recipient)

Recipients that will be included by default in all emails composed by user. Relationship recipients cannot be used as a filter.

data (object) or links (object) (role)

The role associated with the user. You can use only the attribute id to filter users by role (e.g. filter[role][id]=X).

Array of data (object) or links (object) (team)

The teams the user belongs to. You can use only the attribute id to filter users by teams (e.g. filter[teams][id]=X).

(user (data (object) or links (object)))

The most recent updater of the user. Relationship updater cannot be used as a filter.

{
}

User Resource Metadata

METADATA NAME DESCRIPTION QUERY PARAM
canWrite A boolean value indicating whether the current API user has write access to this resource. provideAuthorizationMeta
dataConnections The set of connections a given User has to external sources. provideDataConnections

⌵ User Actions

Get a Collection of Users

SecuritybearerAuth and s2sAuthToken
Responses
200

OK

422

JSON error message

get/users
Request samples
Response samples
application/vnd.api+json
{
}

Create a New User

SecuritybearerAuth
Request
Request Body schema: application/vnd.api+json
required
object
Responses
201

Created

422

JSON error message

post/users
Request samples
application/vnd.api+json
{
}
Response samples
application/vnd.api+json
{
}

Get a User by ID

SecuritybearerAuth and s2sAuthToken
Request
path Parameters
id
required
integer
Responses
200

OK

404

Not Found

get/users/{id}
Request samples
Response samples
application/vnd.api+json
{
}

Update a User

SecuritybearerAuth
Request
path Parameters
id
required
integer
Request Body schema: application/vnd.api+json
required
object
Responses
200

OK

422

JSON error message

patch/users/{id}
Request samples
application/vnd.api+json
{
}
Response samples
application/vnd.api+json
{
}