# samva-dev Contacts API

**Canonical:** https://apis.io/apis/samva-dev/samva-dev-contacts-api/  
**Provider:** samva-dev — https://apis.io/providers/samva-dev/  
**Base URL:** https://api.samva.dev  
**Documentation:** https://samva.dev/docs/api-reference

samva-dev Contacts API is one of 34 APIs that [samva-dev](https://apis.io/providers/samva-dev/) 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.

Contact CRUD, bulk operations, engagement metrics, and activity timeline

## Operations (22)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/contacts` | List contacts |
| POST | `/v1/contacts` | Create a contact |
| POST | `/v1/contacts/find` | Find a contact |
| POST | `/v1/contacts/find-or-create` | Find or create a contact |
| GET | `/v1/contacts/{id}` | Get a contact |
| PATCH | `/v1/contacts/{id}` | Update a contact |
| DELETE | `/v1/contacts/{id}` | Delete a contact |
| POST | `/v1/contacts/{id}/identities` | Add a contact identity |
| DELETE | `/v1/contacts/{id}/identities/{identityId}` | Remove a contact identity |
| PUT | `/v1/contacts/{id}/identities/{identityId}/consent/{channel}` | Record contact consent |
| POST | `/v1/contacts/{id}/tags` | Add contact tags |
| DELETE | `/v1/contacts/{id}/tags` | Remove contact tags |
| GET | `/v1/contacts/{id}/engagement` | Get contact engagement metrics |
| POST | `/v1/contacts/imports/plan` | Preview a list migration |
| POST | `/v1/contacts/imports` | Start or resume a list migration |
| GET | `/v1/contacts/imports/{id}` | Get list migration progress |
| POST | `/v1/contacts/bulk-delete` | Bulk delete contacts |
| POST | `/v1/contacts/bulk-update-tags` | Bulk update contact tags |
| POST | `/v1/contacts/bulk-update-status` | Bulk update contact status |
| POST | `/v1/contacts/export` | Export contacts |
| GET | `/v1/contacts/{id}/activity` | Get contact activity timeline |
| GET | `/v1/contacts/{id}/groups` | List a contact's group memberships |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/samva-dev/openapi/samva-dev-contacts-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/samva-dev/json-schema/samva-dev-email-domain-verification-schema.json
- **JSONSchema** — https://artifacts.apis.io/samva-dev/json-schema/samva-dev-contact-schema.json
- **JSONSchema** — https://artifacts.apis.io/samva-dev/json-schema/samva-dev-template-schema.json
- **JSONSchema** — https://artifacts.apis.io/samva-dev/json-schema/samva-dev-conversation-schema.json
- **JSONSchema** — https://artifacts.apis.io/samva-dev/json-schema/samva-dev-message-schema.json
- **JSONSchema** — https://artifacts.apis.io/samva-dev/json-schema/samva-dev-mailbox-message-schema.json

## Other samva-dev APIs (12)

- [samva-dev Agents API](https://apis.io/apis/samva-dev/samva-dev-agents-api/)
- [samva-dev Analytics API](https://apis.io/apis/samva-dev/samva-dev-analytics-api/)
- [samva-dev API Keys API](https://apis.io/apis/samva-dev/samva-dev-api-keys-api/)
- [samva-dev Attachments API](https://apis.io/apis/samva-dev/samva-dev-attachments-api/)
- [samva-dev Brands API](https://apis.io/apis/samva-dev/samva-dev-brands-api/)
- [samva-dev Campaigns API](https://apis.io/apis/samva-dev/samva-dev-campaigns-api/)
- [samva-dev Contact events API](https://apis.io/apis/samva-dev/samva-dev-contact-events-api/)
- [samva-dev Contact Groups API](https://apis.io/apis/samva-dev/samva-dev-contact-groups-api/)
- [samva-dev Conversations API](https://apis.io/apis/samva-dev/samva-dev-conversations-api/)
- [samva-dev Custom Fields API](https://apis.io/apis/samva-dev/samva-dev-custom-fields-api/)
- [samva-dev Email API](https://apis.io/apis/samva-dev/samva-dev-email-api/)
- [samva-dev Events API](https://apis.io/apis/samva-dev/samva-dev-events-api/)

## Tags

Contacts

---

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