manage-contact

# Contact Management

Manage contacts and their channel associations in Sinch Conversation API using the Conversation API specification. Note: MCP tools do not provide contact management tools, so this skill always uses the Conversation API endpoints. Contacts represent end-users and can span multiple messaging channels.

## Instructions

1. **Identify the operation from user request:**
   - **Create contact**: New contact with channel identity
   - **Update contact**: Modify contact information or add channels
   - **List contacts**: Retrieve contacts with optional filtering
   - **Get contact**: Retrieve specific contact details
   - **Find contact**: Search for contact by phone number, email, or ID

2. **Extract contact information:**
   - Contact identifier: phone number, email, contact ID, or name
   - Channel identities: WhatsApp, SMS, or other channels with identities
   - Display name: Contact's display name
   - Email: Contact's email address
   - Language: Preferred language code (e.g., EN_US)

3. **Use Conversation API endpoints to perform operations:**
   - **Note**: MCP Sinch does not provide contact management tools, so this skill always uses the Conversation API endpoints
   - **Create contact**: `POST /v1/projects/{project_id}/contacts` (Operation ID: `Contact_CreateContact`)
   - **Update contact**: `PATCH /v1/projects/{project_id}/contacts/{contact_id}` (Operation ID: `Contact_UpdateContact`)
   - **Get contact**: `GET /v1/projects/{project_id}/contacts/{contact_id}` (Operation ID: `Contact_GetContact`)
   - **List contacts**: `GET /v1/projects/{project_id}/contacts` (Operation ID: `Contact_ListContacts`)
   - Authentication: Use Basic Auth or OAuth2 with credentials from environment variables
   - Region: Use CONVERSATION_REGION environment variable (us, eu, or br)
   - Base URL: `https://{region}.conversation.api.sinch.com`

4. **Response handling:**
   - Confirm successful operations with contact ID
   - Display contact information clearly
   -