> ## 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.

# Zoho CRM: Contact Roles Get Contact Roles

> List the contact roles defined in your Zoho CRM account. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

List the contact roles defined in your Zoho CRM account.

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

## 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(
  'zoho_crm_contact_roles_get_contact_roles',
  {},
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute zoho_crm_contact_roles_get_contact_roles --input '{}' --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": {
    "contact_roles": [
      {
        "name": "Example",
        "id": "id_123",
        "sequence_number": 123
      }
    ]
  }
}
```

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

## Input reference

Retrieves a list of contact roles

This action requires no input fields.

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Retrieves a list of contact roles",
    "properties": {},
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Response containing contact roles |
| `result.data.contact_roles` | `array` | Yes | — | Array of contact roles Maximum items: 100. |
| `result.data.contact_roles[].name` | `string` | Yes | — | Name of the contact role Maximum length: 50. Pattern: `[A-Za-z0-9 ]`. |
| `result.data.contact_roles[].id` | `string` | Yes | — | Unique identifier for the contact role Maximum length: 19. |
| `result.data.contact_roles[].sequence_number` | `number` | Yes | — | Sequence number for ordering |
| `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": "Response containing contact roles",
        "properties": {
          "contact_roles": {
            "type": "array",
            "description": "Array of contact roles",
            "maxItems": 100,
            "items": {
              "type": "object",
              "description": "Contact role details",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "Name of the contact role",
                  "maxLength": 50,
                  "pattern": "[A-Za-z0-9 ]"
                },
                "id": {
                  "type": "string",
                  "description": "Unique identifier for the contact role",
                  "maxLength": 19
                },
                "sequence_number": {
                  "type": "number",
                  "description": "Sequence number for ordering"
                }
              },
              "required": [
                "name",
                "id",
                "sequence_number"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "contact_roles"
        ],
        "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

* [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.