Documentation Index

Fetch the complete documentation index at: https://help.gong.io/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve user (/v2/users/{id})

  • Updated on Nov 17, 2025
  • Published on Oct 19, 2025
  • 2 minute(s) read
Prev Next
Get
/v2/users/{id}

Retrieve a specific user.

Required authorizaton scope: 'api:users:read'.

Path parameters
id
stringRequired

Gong's unique numeric identifier for the user (up to 20 digits).

Responses
200

Successful response

Expand All
object
requestId
string

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
user
object (UserMetadata)

User's metadata.

id
string

Gong's unique numeric identifier for the user (up to 20 digits).

Example234599484848423
emailAddress
string

The email address of the Gong user.

Exampletest@test.com
created
string

Creation time in the ISO-8601 format (e.g., '2018-02-18T02:30:00-07:00' or '2018-02-18T08:00:00Z', where Z stands for UTC);of the Gong user.

Example2018-02-17T02:30:00-08:00
active
boolean

True if the user is active, false if not.

Exampletrue
emailAliases
Array of string

List of email address aliases of the Gong user.

Example[ "testAlias@test.com" ]
string
trustedEmailAddress
string

The trusted authentication email assigned to the Gong user

Exampletest@test.com
firstName
string

The first name of the Gong user.

ExampleJon
lastName
string

The last name of the Gong user.

ExampleSnow
title
string

The job title of the Gong user.

ExampleEnterprise Account Executive
phoneNumber
string

The phone number of the Gong user.

Example+1 123-567-8989
extension
string

The extension number of the Gong user.

Example123
personalMeetingUrls
Array of string

The list of personal meeting URLs of the Gong user.

Example[ "https://zoom.us/j/123" ]
string
settings
object (Settings)

The user's settings in the Gong system.

webConferencesRecorded
boolean

True if the team member is set to be recorded by Gong, false if not.

Exampletrue
preventWebConferenceRecording
boolean

If true, invitation of this user to a web conference will prevent its recording (even if other users invited are set to record).

telephonyCallsImported
boolean

True if the team member is set to import telephony calls from by Gong, false if not.

emailsImported
boolean

True if the team member is set to import emails by Gong, false if not.

Exampletrue
preventEmailImport
boolean

True if the team member is set to prevent import of emails by Gong, false if not.

nonRecordedMeetingsImported
boolean

True if the team member is set to import non recorded meetings by Gong, false if not.

Exampletrue
gongConnectEnabled
boolean

True if the team member has Gong Connect enabled, false if not.

Exampletrue
managerId
string

The manager ID of the Gong user.

Example563515258458745
meetingConsentPageUrl
string

The Gong recording consent meeting link

Examplehttps://join.gong.io/my-company/jon.snow?tkn=MoNpS9tMNt8BK7EZxQpSJl
spokenLanguages
Array of object (spokenLanguage)
object

Languages spoken during calls by the Gong user

language
string

Language spoken by the user encoded according to the BCP-47 standard.

Examplees-ES
primary
boolean

Indicates the primary language (one per user). The language will be assumed when the system cannot identify the language of a call, e.g., due to poor quality or the call being too short.

Exampletrue
400

Malformed request

object
requestId
string

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors
Array of string

Error messages.

Example[ "An error has occurred" ]
string
401

Access denied

object
requestId
string

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors
Array of string

Error messages.

Example[ "An error has occurred" ]
string
404

User not found

object
requestId
string

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors
Array of string

Error messages.

Example[ "An error has occurred" ]
string
429

API request limit exceeded

Headers
Retry-After
integer
Number of seconds to wait before making a new request.
object
requestId
string

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors
Array of string

Error messages.

Example[ "An error has occurred" ]
string
500

Failed to complete the operation due to an unexpected error

object
requestId
string

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors
Array of string

Error messages.

Example[ "An error has occurred" ]
string