> ## 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: Delete Custom Object Instances By ID

> Delete an Intercom custom object record by its external ID. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Delete an Intercom custom object record by its external ID.

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

## Run this action

This action has conditional or dynamic inputs. A static example cannot describe these inputs reliably.

Read the live contract before you execute this action:

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline describe intercom_delete_custom_object_instances_by_id --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": {
    "object": "example",
    "id": "id_123",
    "deleted": true
  }
}
```

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

## Input reference

Delete a single Custom Object instance by external\_id.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.custom_object_type_identifier` | `string` | Yes | — | The unique identifier of the custom object type that defines the structure of the custom object instance. |
| `payload.external_id` | `string` | Yes | — | The unique identifier for the instance in the external system it originated from. |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Delete a single Custom Object instance by external_id.",
    "properties": {
      "custom_object_type_identifier": {
        "type": "string",
        "description": "The unique identifier of the custom object type that defines the structure of the custom object instance."
      },
      "external_id": {
        "type": "string",
        "description": "The unique identifier for the instance in the external system it originated from.",
        "properties": {
          "external_id": {
            "type": "string"
          }
        },
        "required": [
          "external_id"
        ],
        "additionalProperties": false
      }
    },
    "required": [
      "custom_object_type_identifier",
      "external_id"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | deleted custom object instance object |
| `result.data.object` | `string` | No | — | The unique identifier of the Custom Object type that defines the structure of the Custom Object instance. |
| `result.data.id` | `string` | No | — | The Intercom defined id representing the Custom Object instance. |
| `result.data.deleted` | `boolean` | No | — | Whether the Custom Object instance is deleted or not. |
| `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": "deleted custom object instance object",
        "properties": {
          "object": {
            "type": "string",
            "description": "The unique identifier of the Custom Object type that defines the structure of the Custom Object instance."
          },
          "id": {
            "type": "string",
            "description": "The Intercom defined id representing the Custom Object instance."
          },
          "deleted": {
            "type": "boolean",
            "description": "Whether the Custom Object instance is deleted or not."
          }
        },
        "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.