# Contacts

HTML: https://www.app2email.com/docs/api/contacts · Index: https://www.app2email.com/docs/api/llms.txt

Contacts with tags, custom fields and consent records, and segments (saved filters) to send to.

| Method | Path | Summary | Scope | Sandbox key |
| --- | --- | --- | --- | --- |
| GET | `/v1/{number}/contacts` | [Your contacts, newest first](https://www.app2email.com/docs/api/contacts/list-contacts.md) | `messages:read` | reads |
| POST | `/v1/{number}/contacts` | [Make or update contacts (one, or a list of up to 1000)](https://www.app2email.com/docs/api/contacts/upsert-contacts.md) | `contacts:manage` | real change |
| POST | `/v1/{number}/contacts/import` | [Import contacts from CSV or JSON (up to 5000 rows)](https://www.app2email.com/docs/api/contacts/import-contacts.md) | `contacts:manage` | real change |
| GET | `/v1/{number}/contacts/export.csv` | [All contacts as CSV](https://www.app2email.com/docs/api/contacts/export-contacts.md) | `messages:read` | reads |
| GET | `/v1/{number}/contacts/{identity}` | [One contact](https://www.app2email.com/docs/api/contacts/get-contact.md) | `messages:read` | reads |
| PATCH | `/v1/{number}/contacts/{identity}` | [Change a contact](https://www.app2email.com/docs/api/contacts/update-contact.md) | `contacts:manage` | real change |
| DELETE | `/v1/{number}/contacts/{identity}` | [Delete a contact record](https://www.app2email.com/docs/api/contacts/delete-contact.md) | `contacts:manage` | simulated |
| POST | `/v1/{number}/contacts/{identity}/consent` | [Record consent (or its withdrawal) with evidence](https://www.app2email.com/docs/api/contacts/record-consent.md) | `contacts:manage` | real change |
| GET | `/v1/{number}/segments` | [Your segments (saved contact filters)](https://www.app2email.com/docs/api/contacts/list-segments.md) | `messages:read` | reads |
| POST | `/v1/{number}/segments` | [Save a contact filter as a segment](https://www.app2email.com/docs/api/contacts/create-segment.md) | `contacts:manage` | real change |
| GET | `/v1/{number}/segments/{id}` | [One segment, with how many contacts match now](https://www.app2email.com/docs/api/contacts/get-segment.md) | `messages:read` | reads |
| PUT | `/v1/{number}/segments/{id}` | [Rename a segment or replace its filter](https://www.app2email.com/docs/api/contacts/update-segment.md) | `contacts:manage` | real change |
| DELETE | `/v1/{number}/segments/{id}` | [Delete a segment (its contacts stay)](https://www.app2email.com/docs/api/contacts/delete-segment.md) | `contacts:manage` | real change |
| GET | `/v1/{number}/segments/{id}/contacts` | [The contacts a segment matches now](https://www.app2email.com/docs/api/contacts/list-segment-contacts.md) | `messages:read` | reads |
| GET | `/v1/{number}/blocked` | [WhatsApp users this number blocked](https://www.app2email.com/docs/api/contacts/list-blocked-users.md) | `messages:read` | reads |
| POST | `/v1/{number}/blocked` | [Block WhatsApp users](https://www.app2email.com/docs/api/contacts/block-users.md) | `contacts:manage` | refused |
| DELETE | `/v1/{number}/blocked` | [Unblock WhatsApp users](https://www.app2email.com/docs/api/contacts/unblock-users.md) | `contacts:manage` | refused |
| GET | `/v1/{number}/contact-book/{bsuid}` | [Is a phone number on file for a business-scoped user id](https://www.app2email.com/docs/api/contacts/get-contact-book-entry.md) | `messages:read` | reads |
| DELETE | `/v1/{number}/contact-book/{bsuid}` | [Remove a business-scoped user id from the contact book](https://www.app2email.com/docs/api/contacts/delete-contact-book-entry.md) | `contacts:manage` | refused |
