---
title: "Remove from Telegram contacts"
locale: en
url: https://tlg.builera.app/en/docs/reference/rest/people.delete_contact
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Remove from Telegram contacts

Remove the person from this account's Telegram contacts. The chat, its history and the CRM card stay.

Remove the person from this account's Telegram contacts. The chat, its history and the CRM card stay.

## Overview

| Name | Value |
| --- | --- |
| Code | `people.delete_contact` |
| Scope needed | `contacts.write` |
| Risk | Dangerous |
| May need confirmation | Yes |
| Runs as | Queues work for a node |
| Needs `Idempotency-Key` | Yes |
| Member roles allowed | `owner`, `manager`, `agent` |
| Needs a worker from version | `1.0.16` |
| In the app | Inbox → customer info → Remove from contacts |

## Input fields

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `conversationId` | `uuid` | Yes |   |

## Example request

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/people.delete_contact \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <unique key per operation>" \
  -d '{"conversationId":"00000000-0000-0000-0000-000000000000"}'
```

## Output fields (`data`)

| Field | Type | Required |
| --- | --- | --- |
| `ok` | `true` | Yes |
| `jobId` | `text` | Yes |

## Example answer

```json
{
  "data": {
    "ok": true,
    "jobId": "00000000-0000-4000-8000-000000000000"
  }
}
```

## Using it over MCP

Not listed on any profile: call `tools_describe` then `tools_run` with `code: "people.delete_contact"`. Tool name when listed: `people_delete_contact`.
