---
title: "Sync Discovered Contact"
method: POST
path: "/api/contacts/discover/sync"
tags: ["contacts", "contacts"]
---

# Sync Discovered Contact

`POST /api/contacts/discover/sync`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/contacts/discover/sync`
- Auth: none declared

Sync a specific contact by their Telegram user ID.

After using /discover/search to find a contact, use this endpoint
to sync them and load their DM history.

## Request body

- ContactSyncRequest: Request to sync a specific contact.
  - `channel` string
  - `user_id` integer, nullable
  - `identifier` string, nullable

## Response `200`

Successful Response

- ContactSyncResponse: Response for contact sync.
  - `success` boolean, required
  - `thread_id` integer, nullable
  - `thread_ref` string, nullable
  - `person_id` integer, nullable
  - `entity_id` integer, nullable
  - `title` string, nullable
  - `has_messages` boolean
  - `channel_account_id` integer, nullable
  - `error` string, nullable
  - `error_code` string, nullable
  - `retry_after_seconds` integer, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/77bef09a9209?raw)