# Sinch Contact API **Canonical:** https://apis.io/apis/sinch/sinch-contact-api/ **Provider:** Sinch — https://apis.io/providers/sinch/ **Base URL:** https://us.conversation.api.sinch.com **Documentation:** https://developers.sinch.com/docs/conversation/api-reference/conversation Sinch Contact API is one of 101 APIs that [Sinch](https://apis.io/providers/sinch/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. This API exposes 73 JSON Schema definitions. Tagged areas include Contact. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, an AsyncAPI specification, and 73 JSON Schemas. A contact is a collection that groups together underlying connected **channel recipient identities**. It's tied to a specific **project** and is therefore considered public to all **apps** sharing the same **project**. Most contact creation and maintenance is handled by the Conversation API's automatic [contact management](https://developers.sinch.com/docs/conversation/contact-management/) processes. However, you can also use API calls to manually manage your contacts. A **contact** has the following configurable properties: | Field | Description | | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- | | Channel identities | List of channel identities specifying how the contact is identified on underlying channels | | Channel priority | Specifies the channel priority order used when sending messages to this contact. This can be overridden by message specific channel priority order. | | Display name | Optional display name used in chat windows and other UIs | | Email | Optional Email of the contact | | External id | Optional identifier of the contact in external systems | | Metadata | Optional metadata associated with the contact. | ## Operations (8) | Method | Path | Summary | |---|---|---| | GET | `/v1/projects/{project_id}/contacts` | List Contacts | | POST | `/v1/projects/{project_id}/contacts` | Create a Contact | | GET | `/v1/projects/{project_id}/contacts/{contact_id}` | Get a Contact | | DELETE | `/v1/projects/{project_id}/contacts/{contact_id}` | Delete a Contact | | PATCH | `/v1/projects/{project_id}/contacts/{contact_id}` | Update a Contact | | POST | `/v1/projects/{project_id}/contacts/{destination_id}:merge` | Merge two Contacts | | POST | `/v1/projects/{project_id}/contacts:getChannelProfile` | Get Channel Profile | | GET | `/v1/projects/{project_id}/contacts:identityConflicts` | Lists Contact Identity Conflicts | ## Machine-readable artifacts (107) - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/openapi/sinch-contact-api-openapi.yml - **Documentation** — https://developers.sinch.com/docs/conversation - **APIReference** — https://developers.sinch.com/docs/conversation/api-reference/template - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-v2-template-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-v2-list-translations-response-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-v2-list-templates-response-schema.json - **Documentation** — https://developers.sinch.com/docs/est - **APIReference** — https://developers.sinch.com/docs/est/api-reference/est - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-call-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-sip-trunk-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-sip-endpoint-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-ip-range-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-access-control-list-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-number-schema.json - **Documentation** — https://developers.sinch.com/docs/fax - **APIReference** — https://developers.sinch.com/docs/fax/api-reference/fax - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-fax-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-service-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-template-by-name-response-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-update-template-request-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-service-phone-number-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-cover-page-schema.json - **Documentation** — https://developers.sinch.com/docs/number-lookup-api-v2 - **APIReference** — https://developers.sinch.com/docs/number-lookup-api-v2/api-reference/number-lookup-v2 - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-number-lookup-response-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-number-lookup-request-schema.json - **Documentation** — https://developers.sinch.com/docs/numbers - **APIReference** — https://developers.sinch.com/docs/numbers/api-reference/imported-hosting - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-hosting-order-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-qualified-number-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-text-enable-numbers-request-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-hosting-order-number-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-imported-number-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-list-imported-numbers-response-schema.json - **APIReference** — https://developers.sinch.com/docs/numbers/api-reference/numbers - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-active-number-response-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-rent-any-number-request-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-validate-address-response-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-number-order-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sinch/refs/heads/main/json-schema/sinch-create-number-order-request-schema.json - …and 67 more, listed in full on the page. ## Other Sinch APIs (12) - [Sinch Conversation API](https://apis.io/apis/sinch/sinch-conversation-api/) - [Sinch Voice API](https://apis.io/apis/sinch/sinch-voice-api/) - [Sinch Brands API](https://apis.io/apis/sinch/sinch-brands-api/) - [Sinch MMS API](https://apis.io/apis/sinch/sinch-mms-api/) - [Sinch Batches API](https://apis.io/apis/sinch/sinch-batches-api/) - [Sinch Delivery Reports API](https://apis.io/apis/sinch/sinch-delivery-reports-api/) - [Sinch Inbounds API](https://apis.io/apis/sinch/sinch-inbounds-api/) - [Sinch Groups API](https://apis.io/apis/sinch/sinch-groups-api/) - [Sinch 10DLC Brand Registration API](https://apis.io/apis/sinch/sinch-10dlc-brand-registration-api/) - [Sinch 10DLC Campaign Registration API](https://apis.io/apis/sinch/sinch-10dlc-campaign-registration-api/) - [Sinch Access Control List API](https://apis.io/apis/sinch/sinch-access-control-list-api/) - [Sinch Access Control Lists API](https://apis.io/apis/sinch/sinch-access-control-lists-api/) ## Tags Contact --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/sinch/sinch-contact-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/sinch/.