> ## 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: Get User

> Get one Gong user's profile and settings by user ID. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Get one Gong user's profile and settings by user ID.

> [!NOTE]
>
> Tool ID: `gong_get_user`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'gong_get_user',
  {
    "id": "id_123"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute gong_get_user --input '{
  "id": "id_123"
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "requestId": "request_123",
    "user": {
      "id": "id_123",
      "emailAddress": "jane.doe@example.com",
      "created": "example"
    }
  }
}
```

Use `deepline describe gong_get_user --json` for the latest machine-readable contract.

## Input reference

Retrieve a specific user. When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:users:read'.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.id` | `string` | Yes | — | Gong's unique numeric identifier for the user (up to 20 digits). |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Retrieve a specific user. When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:users:read'.",
    "properties": {
      "id": {
        "type": "string",
        "description": "Gong's unique numeric identifier for the user (up to 20 digits)."
      }
    },
    "required": [
      "id"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.requestId` | `string` | No | — | A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes. |
| `result.data.user` | `object` | No | — | User's metadata. |
| `result.data.user.id` | `string` | No | — | Gong's unique numeric identifier for the user (up to 20 digits). |
| `result.data.user.emailAddress` | `string` | No | — | The email address of the Gong user. |
| `result.data.user.created` | `string` | No | — | 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. |
| `result.data.user.active` | `boolean` | No | — | True if the user is active, false if not. |
| `result.data.user.emailAliases` | `array` | No | — | List of email address aliases of the Gong user. |
| `result.data.user.trustedEmailAddress` | `string` | No | — | The trusted authentication email assigned to the Gong user |
| `result.data.user.firstName` | `string` | No | — | The first name of the Gong user. |
| `result.data.user.lastName` | `string` | No | — | The last name of the Gong user. |
| `result.data.user.title` | `string` | No | — | The job title of the Gong user. |
| `result.data.user.phoneNumber` | `string` | No | — | The phone number of the Gong user. |
| `result.data.user.extension` | `string` | No | — | The extension number of the Gong user. |
| `result.data.user.personalMeetingUrls` | `array` | No | — | The list of personal meeting URLs of the Gong user. |
| `result.data.user.settings` | `object` | No | — | The user's settings in the Gong system. |
| `result.data.user.settings.webConferencesRecorded` | `boolean` | No | — | True if the team member is set to be recorded by Gong, false if not. |
| `result.data.user.settings.preventWebConferenceRecording` | `boolean` | No | — | If true, invitation of this user to a web conference will prevent its recording (even if other users invited are set to record). |
| `result.data.user.settings.telephonyCallsImported` | `boolean` | No | — | True if the team member is set to import telephony calls from by Gong, false if not. |
| `result.data.user.settings.emailsImported` | `boolean` | No | — | True if the team member is set to import emails by Gong, false if not. |
| `result.data.user.settings.preventEmailImport` | `boolean` | No | — | True if the team member is set to prevent import of emails by Gong, false if not. |
| `result.data.user.settings.nonRecordedMeetingsImported` | `boolean` | No | — | True if the team member is set to import non recorded meetings by Gong, false if not. |
| `result.data.user.settings.gongConnectEnabled` | `boolean` | No | — | True if the team member has Gong Connect enabled, false if not. |
| `result.data.user.managerId` | `string` | No | — | The manager ID of the Gong user. |
| `result.data.user.meetingConsentPageUrl` | `string` | No | — | The Gong recording consent meeting link |
| `result.data.user.conferencingProviders` | `array` | No | — | The list of web conferencing providers configured for this user, including which is the default. |
| `result.data.user.conferencingProviders[].provider` | `string` | No | — | The provider identifier. |
| `result.data.user.conferencingProviders[].isDefault` | `boolean` | No | — | True if this is the user's default conferencing provider. |
| `result.data.user.spokenLanguages` | `array` | No | — | — |
| `result.data.user.spokenLanguages[].language` | `string` | No | — | Language spoken by the user encoded according to the BCP-47 standard. |
| `result.data.user.spokenLanguages[].primary` | `boolean` | No | — | 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. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "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."
          },
          "user": {
            "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
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Gong provider guide](https://deepline.com/docs/providers/gong/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.