# sendly-now Contacts API

**Canonical:** https://apis.io/apis/sendly-now/sendly-now-contacts-api/  
**Provider:** sendly-now — https://apis.io/providers/sendly-now/  
**Base URL:** https://api.sendly.now  
**Documentation:** https://docs.sendly.now/api-reference/overview

sendly-now Contacts API is one of 27 APIs that [sendly-now](https://apis.io/providers/sendly-now/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Contacts. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Manage subscribers and per-contact custom data.

## Operations (25)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/contacts` | List contacts |
| POST | `/api/contacts` | Create a contact |
| DELETE | `/api/contacts/bulk` | Bulk-delete contacts |
| POST | `/api/contacts/bulk` | Bulk-create contacts |
| POST | `/api/contacts/bulk-delete` | Delete up to 1000 contacts, by id (contactIds) or by email address (emails) |
| POST | `/api/contacts/bulk-purge` | Permanently erase up to 1000 contacts and their history, and block their… |
| POST | `/api/contacts/bulk-subscribe` | Subscribe or unsubscribe up to 1000 contacts at once |
| POST | `/api/contacts/bulk-unsubscribe` | Subscribe or unsubscribe up to 1000 contacts at once |
| GET | `/api/contacts/export` | Get a one-time link the user opens to download this project's contacts as CSV |
| GET | `/api/contacts/fields` | List the custom contact fields this project uses |
| DELETE | `/api/contacts/fields/{field}` | Remove a custom field and its values from every contact |
| GET | `/api/contacts/fields/{field}/usage` | Show which segments, templates and workflows use a custom field |
| GET | `/api/contacts/fields/{field}/values` | List the distinct values stored in a custom field |
| POST | `/api/contacts/import` | Import contacts from CSV text, up to 5 MB |
| POST | `/api/contacts/lookup` | Find contacts by email address, up to 500 addresses per call |
| POST | `/api/contacts/upsert` | Create or update a contact by email |
| DELETE | `/api/contacts/{id}` | Delete a contact |
| GET | `/api/contacts/{id}` | Get a contact |
| PATCH | `/api/contacts/{id}` | Update a contact |
| POST | `/api/contacts/{id}/purge` | Permanently erase one contact and every event about them, and block the address… |
| GET | `/api/v1/contacts` | List contacts |
| POST | `/api/v1/contacts` | Create a contact |
| DELETE | `/api/v1/contacts/{id}` | Delete a contact |
| GET | `/api/v1/contacts/{id}` | Retrieve a contact |
| PATCH | `/api/v1/contacts/{id}` | Update a contact |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/sendly-now/openapi/sendly-now-contacts-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/sendly-now/json-schema/sendly-now-compose-mailbox-message-schema.json
- **JSONSchema** — https://artifacts.apis.io/sendly-now/json-schema/sendly-now-mailbox-conversation-reply-body-schema.json
- **JSONSchema** — https://artifacts.apis.io/sendly-now/json-schema/sendly-now-domain-logo-readiness-v1-schema.json
- **JSONSchema** — https://artifacts.apis.io/sendly-now/json-schema/sendly-now-send-email-schema.json
- **JSONSchema** — https://artifacts.apis.io/sendly-now/json-schema/sendly-now-send-email-v1-schema.json
- **JSONSchema** — https://artifacts.apis.io/sendly-now/json-schema/sendly-now-domain-schema.json

## Other sendly-now APIs (12)

- [sendly-now Account API](https://apis.io/apis/sendly-now/sendly-now-account-api/)
- [sendly-now Analytics API](https://apis.io/apis/sendly-now/sendly-now-analytics-api/)
- [sendly-now API Keys API](https://apis.io/apis/sendly-now/sendly-now-api-keys-api/)
- [sendly-now Billing API](https://apis.io/apis/sendly-now/sendly-now-billing-api/)
- [sendly-now Campaigns API](https://apis.io/apis/sendly-now/sendly-now-campaigns-api/)
- [sendly-now Compatibility API](https://apis.io/apis/sendly-now/sendly-now-compatibility-api/)
- [sendly-now Connections API](https://apis.io/apis/sendly-now/sendly-now-connections-api/)
- [sendly-now Deliverability API](https://apis.io/apis/sendly-now/sendly-now-deliverability-api/)
- [sendly-now Domains API](https://apis.io/apis/sendly-now/sendly-now-domains-api/)
- [sendly-now Emails API](https://apis.io/apis/sendly-now/sendly-now-emails-api/)
- [sendly-now Events API](https://apis.io/apis/sendly-now/sendly-now-events-api/)
- [sendly-now Lists API](https://apis.io/apis/sendly-now/sendly-now-lists-api/)

## Tags

Contacts

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/sendly-now/sendly-now-contacts-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/sendly-now/.