# Contacts

> People you can message: contacts, tags, opt-in state.

Last updated: 2026-10-25. Source: https://docs.smartchat.marketing/en/api/reference/contacts/

People you can message: contacts, tags, opt-in state.

| Operation | Call | Permission | Risk |
|---|---|---|---|
| [Search contacts](https://docs.smartchat.marketing/en/api/reference/contacts/search_contacts/) | `GET /v1/contacts` | `contacts:read` | Read |
| [Get contact](https://docs.smartchat.marketing/en/api/reference/contacts/get_contact/) | `GET /v1/contacts/{contact_id}` | `contacts:read` | Read |
| [Create contact](https://docs.smartchat.marketing/en/api/reference/contacts/create_contact/) | `POST /v1/contacts` | `contacts:write` | Write (no outside effect) |
| [Update contact](https://docs.smartchat.marketing/en/api/reference/contacts/update_contact/) | `PATCH /v1/contacts/{contact_id}` | `contacts:write` | Write (no outside effect) |
| [List tags](https://docs.smartchat.marketing/en/api/reference/contacts/list_tags/) | `GET /v1/tags` | `contacts:read` | Read |
| [Tag contacts](https://docs.smartchat.marketing/en/api/reference/contacts/tag_contacts/) | `POST /v1/contacts/tags` | `contacts:write` | Write (no outside effect) |
| [Unsubscribe contact](https://docs.smartchat.marketing/en/api/reference/contacts/unsubscribe_contact/) | `POST /v1/contacts/{contact_id}/unsubscribe` | `contacts:unsubscribe` | Write (no outside effect) |
| [Create contact export](https://docs.smartchat.marketing/en/api/reference/contacts/create_contact_export/) | `POST /v1/contact-exports` | `contacts:read` | Write (no outside effect) |
| [Get contact export](https://docs.smartchat.marketing/en/api/reference/contacts/get_contact_export/) | `GET /v1/contact-exports/{export_id}` | `contacts:read` | Read |
| [Create opt-in confirmations](https://docs.smartchat.marketing/en/api/reference/contacts/create_optin_confirmations/) | `POST /v1/optin-confirmations` | `sends:create` | Send (reaches other people) |