> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Gong List Users: Inputs, Cost & CLI Example
> List all users (/v2/users). Includes inputs, outputs, pricing notes, Deepline CLI examples, and GTM automation guidance.
## Run in Enrichment Spreadsheet
Use this function as a column step in `deepline enrich`.
```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=gong_list_users:{}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| ------------------------ | --------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `payload.cursor` | `string` | No | | When paging is needed, provide the value supplied by the previous API call to bring the following page of records. |
| `payload.includeAvatars` | `boolean` | No | | Avatars are synthetic users representing Gong employees (CSMs and support providers) when they access your instance. References to avatars' IDs may be found in the outputs of other API endpoints. This parameter is optional, if not provided avatars will not be included in the results. |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "List all of the company's users. When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:users:read'.",
"properties": {
"cursor": {
"type": "string",
"description": "When paging is needed, provide the value supplied by the previous API call to bring the following page of records."
},
"includeAvatars": {
"type": "boolean",
"description": "Avatars are synthetic users representing Gong employees (CSMs and support providers) when they access your instance. References to avatars' IDs may be found in the outputs of other API endpoints. This parameter is optional, if not provided avatars will not be included in the results."
}
},
"required": [],
"additionalProperties": false
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes | | Provider response payload. |
| `result.meta` | `object` | No | | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"description": "Standard tool result payload.",
"properties": {
"data": {
"type": "object",
"description": "Provider response payload.",
"properties": {
"requestId": {
"type": "string",
"description": "A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes."
},
"records": {
"type": "object",
"description": "Information about the number of records that match the requested filter.",
"properties": {
"totalRecords": {
"type": "integer",
"description": "Total number of records.",
"format": "int32"
},
"currentPageSize": {
"type": "integer",
"description": "Number of records in the current page.",
"format": "int32"
},
"currentPageNumber": {
"type": "integer",
"description": "Current page number.",
"format": "int32"
},
"cursor": {
"type": "string",
"description": "Returned only when there are more records to be retrieved. Repeat the API call and pass this cursor value in the request to retrieve the next page of records."
}
},
"additionalProperties": false
},
"users": {
"type": "array",
"description": "A list, in which each item specifies one user's metadata.",
"items": {
"type": "object",
"description": "User's metadata.",
"properties": {
"id": {
"type": "string",
"description": "Gong's unique numeric identifier for the user (up to 20 digits)."
},
"emailAddress": {
"type": "string",
"description": "The email address of the Gong user."
},
"created": {
"type": "string",
"description": "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."
},
"active": {
"type": "boolean",
"description": "True if the user is active, false if not."
},
"emailAliases": {
"type": "array",
"description": "List of email address aliases of the Gong user.",
"items": {
"type": "string"
}
},
"trustedEmailAddress": {
"type": "string",
"description": "The trusted authentication email assigned to the Gong user"
},
"firstName": {
"type": "string",
"description": "The first name of the Gong user."
},
"lastName": {
"type": "string",
"description": "The last name of the Gong user."
},
"title": {
"type": "string",
"description": "The job title of the Gong user."
},
"phoneNumber": {
"type": "string",
"description": "The phone number of the Gong user."
},
"extension": {
"type": "string",
"description": "The extension number of the Gong user."
},
"personalMeetingUrls": {
"type": "array",
"description": "The list of personal meeting URLs of the Gong user.",
"items": {
"type": "string"
}
},
"settings": {
"type": "object",
"description": "The user's settings in the Gong system.",
"properties": {
"webConferencesRecorded": {
"type": "boolean",
"description": "True if the team member is set to be recorded by Gong, false if not."
},
"preventWebConferenceRecording": {
"type": "boolean",
"description": "If true, invitation of this user to a web conference will prevent its recording (even if other users invited are set to record)."
},
"telephonyCallsImported": {
"type": "boolean",
"description": "True if the team member is set to import telephony calls from by Gong, false if not."
},
"emailsImported": {
"type": "boolean",
"description": "True if the team member is set to import emails by Gong, false if not."
},
"preventEmailImport": {
"type": "boolean",
"description": "True if the team member is set to prevent import of emails by Gong, false if not."
},
"nonRecordedMeetingsImported": {
"type": "boolean",
"description": "True if the team member is set to import non recorded meetings by Gong, false if not."
},
"gongConnectEnabled": {
"type": "boolean",
"description": "True if the team member has Gong Connect enabled, false if not."
}
},
"additionalProperties": false
},
"managerId": {
"type": "string",
"description": "The manager ID of the Gong user."
},
"meetingConsentPageUrl": {
"type": "string",
"description": "The Gong recording consent meeting link"
},
"conferencingProviders": {
"type": "array",
"description": "The list of web conferencing providers configured for this user, including which is the default.",
"items": {
"type": "object",
"description": "A web conferencing provider configured in the user's consent profile",
"properties": {
"provider": {
"type": "string",
"description": "The provider identifier."
},
"isDefault": {
"type": "boolean",
"description": "True if this is the user's default conferencing provider."
}
},
"additionalProperties": false
}
},
"spokenLanguages": {
"type": "array",
"items": {
"type": "object",
"description": "Languages spoken during calls by the Gong user",
"properties": {
"language": {
"type": "string",
"description": "Language spoken by the user encoded according to the BCP-47 standard."
},
"primary": {
"type": "boolean",
"description": "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."
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"meta": {
"type": "object",
"description": "Additional response metadata (status, paging).",
"additionalProperties": true
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## Advanced: Direct CLI
Use direct execution for single payload debugging.
```bash theme={null}
deepline tools execute gong_list_users --payload '{}' --json
```
### CLI flags
| Flag | Description |
| --------------------------- | --------------------------------------------------- |
| `--json` | Print machine-readable output. |
| `--wait` | Wait for terminal provider status when supported. |
| `--debug` | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS` | Max seconds to wait in wait mode. |
| `--poll-interval SECONDS` | Polling interval in seconds during wait mode. |
| `--timeout SECONDS` | Request timeout in seconds. |
| `--connect-timeout SECONDS` | Connection timeout in seconds. |
## Cost
* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.
* Billing mode: `no_bill`.