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

# Intercom: List Handling Events

> List when teammates paused or resumed handling an Intercom conversation. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

List when teammates paused or resumed handling an Intercom conversation.

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

## 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(
  'intercom_list_handling_events',
  {
    "id": "id_123"
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute intercom_list_handling_events --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": {
    "handling_events": [
      {
        "teammate": {
          "type": "admin",
          "id": 123,
          "name": "Example"
        },
        "type": "paused",
        "timestamp": "2026-01-15T12:00:00Z"
      }
    ]
  }
}
```

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

## Input reference

List all pause/resume events for a conversation. These events track when teammates paused or resumed handling a conversation. Requires the `read_conversations` OAuth scope.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.id` | `string` | Yes | — | The identifier for the conversation as given by Intercom. |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "List all pause/resume events for a conversation. These events track when teammates paused or resumed handling a conversation. Requires the `read_conversations` OAuth scope.",
    "properties": {
      "id": {
        "type": "string",
        "description": "The identifier for the conversation as given by Intercom."
      }
    },
    "required": [
      "id"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | A list of handling events for a conversation |
| `result.data.handling_events` | `array` | No | — | Array of handling events |
| `result.data.handling_events[].teammate` | `object` | Yes | — | A reference to a teammate |
| `result.data.handling_events[].teammate.type` | `"admin" \| "team" \| "bot"` | Yes | — | The type of teammate Allowed: `admin`, `team`, `bot`. |
| `result.data.handling_events[].teammate.id` | `integer` | Yes | — | The unique identifier of the teammate |
| `result.data.handling_events[].teammate.name` | `string` | Yes | — | The display name of the teammate |
| `result.data.handling_events[].teammate.email` | `string \| null` | No | — | The email address of the teammate (optional for teams/bots) Format: `email`. |
| `result.data.handling_events[].type` | `"paused" \| "resumed"` | Yes | — | The type of handling event Allowed: `paused`, `resumed`. |
| `result.data.handling_events[].timestamp` | `string` | Yes | — | ISO8601 timestamp when the event occurred Format: `date-time`. |
| `result.data.handling_events[].reason` | `string \| null` | No | — | Optional reason for the event (e.g., "Paused", "Away") |
| `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": "A list of handling events for a conversation",
        "properties": {
          "handling_events": {
            "type": "array",
            "description": "Array of handling events",
            "items": {
              "type": "object",
              "description": "A pause or resume event for a conversation",
              "properties": {
                "teammate": {
                  "type": "object",
                  "description": "A reference to a teammate",
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "The type of teammate",
                      "enum": [
                        "admin",
                        "team",
                        "bot"
                      ]
                    },
                    "id": {
                      "type": "integer",
                      "description": "The unique identifier of the teammate"
                    },
                    "name": {
                      "type": "string",
                      "description": "The display name of the teammate"
                    },
                    "email": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The email address of the teammate (optional for teams/bots)",
                      "format": "email"
                    }
                  },
                  "required": [
                    "type",
                    "id",
                    "name"
                  ],
                  "additionalProperties": false
                },
                "type": {
                  "type": "string",
                  "description": "The type of handling event",
                  "enum": [
                    "paused",
                    "resumed"
                  ]
                },
                "timestamp": {
                  "type": "string",
                  "description": "ISO8601 timestamp when the event occurred",
                  "format": "date-time"
                },
                "reason": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Optional reason for the event (e.g., \"Paused\", \"Away\")"
                }
              },
              "required": [
                "teammate",
                "type",
                "timestamp"
              ],
              "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

* [Intercom provider guide](https://deepline.com/docs/providers/intercom/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.