> ## 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: Block Contact

> Block an Intercom contact as spam and archive their conversations. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Block an Intercom contact as spam and archive their conversations.

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

## 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_block_contact',
  {
    "contact_id": "contact_123"
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute intercom_block_contact --input '{
  "contact_id": "contact_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": {
    "type": "contact",
    "id": "id_123",
    "external_id": "external_123"
  }
}
```

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

## Input reference

Block a single contact. **Note:** conversations of the contact will also be archived during the process. More details in [FAQ How do I block Inbox spam?](https://www.intercom.com/help/en/articles/8838656-inbox-faqs)

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.contact_id` | `string` | Yes | — | contact\_id |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Block a single contact. **Note:** conversations of the contact will also be archived during the process. More details in [FAQ How do I block Inbox spam?](https://www.intercom.com/help/en/articles/8838656-inbox-faqs)",
    "properties": {
      "contact_id": {
        "type": "string",
        "description": "contact_id"
      }
    },
    "required": [
      "contact_id"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | reference to contact object |
| `result.data.type` | `"contact"` | No | — | always contact Allowed: `contact`. |
| `result.data.id` | `string` | No | — | The unique identifier for the contact which is given by Intercom. |
| `result.data.external_id` | `string \| null` | No | — | The unique identifier for the contact which is provided by the Client. |
| `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": "reference to contact object",
        "properties": {
          "type": {
            "type": "string",
            "description": "always contact",
            "enum": [
              "contact"
            ]
          },
          "id": {
            "type": "string",
            "description": "The unique identifier for the contact which is given by Intercom."
          },
          "external_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "The unique identifier for the contact which is provided by the Client."
          }
        },
        "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.