> ## 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 Users Access To Calls

> List the Gong users who were given individual access to calls. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

List the Gong users who were given individual access to calls.

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

## 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_users_access_to_calls',
  {
    "filter": {
      "callIds": [
        "call_123"
      ]
    }
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute gong_get_users_access_to_calls --input '{
  "filter": {
    "callIds": [
      "call_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",
    "callAccessList": [
      {
        "callId": "call_123",
        "users": [
          {}
        ]
      }
    ]
  }
}
```

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

## Input reference

Returns a list of users who have received individual access to calls through the API. This endpoint doesn't cover user that have access for other reasons (such as sharing recipients, or access through permission profiles). When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:call-user-access:read'.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.filter` | `object` | Yes | — | — |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Returns a list of users who have received individual access to calls through the API. This endpoint doesn't cover user that have access for other reasons (such as sharing recipients, or access through permission profiles). When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:call-user-access:read'.",
    "properties": {
      "filter": {
        "type": "object",
        "properties": {
          "callIds": {
            "type": "array",
            "description": "Array of Gong's unique numeric call IDs.",
            "uniqueItems": true,
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "callIds"
        ],
        "additionalProperties": false
      }
    },
    "required": [
      "filter"
    ],
    "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.callAccessList` | `array` | No | — | A list, in which each item specifies a call & users with access to this call. |
| `result.data.callAccessList[].callId` | `string` | No | — | Gong's unique numeric call ID. |
| `result.data.callAccessList[].users` | `array` | No | — | A list of users having access. |
| `result.data.callAccessList[].users[].userId` | `string` | No | — | Gong's unique numeric user ID. |
| `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."
          },
          "callAccessList": {
            "type": "array",
            "description": "A list, in which each item specifies a call & users with access to this call.",
            "items": {
              "type": "object",
              "description": "Call access details",
              "properties": {
                "callId": {
                  "type": "string",
                  "description": "Gong's unique numeric call ID."
                },
                "users": {
                  "type": "array",
                  "description": "A list of users having access.",
                  "items": {
                    "type": "object",
                    "description": "User access details",
                    "properties": {
                      "userId": {
                        "type": "string",
                        "description": "Gong's unique numeric user ID."
                      }
                    },
                    "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.