Contacts

Get Contact Available Channels

Get list of channels available to reach a contact.

Returns all channels the tenant has configured that the contact has identifiers for, along with channel-specific status:

  • WhatsApp: Includes window_status with 24h messaging window info
  • Email/Telegram/Messenger/Instagram: Shows as available or unavailable

When for_user_id is not provided, the current user's internal ID is automatically resolved from the auth token and used for mailbox access filtering.

Required Scopes: contacts:read

Response:

{
    "contact_id": "uuid",
    "channels": [
        {
            "channel_id": "uuid",
            "channel_type": "whatsapp",
            "channel_name": "WhatsApp Business",
            "identifier": "+1234567890",
            "status": "available" | "template_required" | "unavailable",
            "window_status": {
                "in_window": false,
                "requires_template": true,
                "last_customer_message_at": "2026-01-14T10:00:00Z",
                "window_end_at": "2026-01-15T10:00:00Z"
            }
        },
        {
            "channel_id": "uuid",
            "channel_type": "email",
            "channel_name": "Support Email",
            "identifier": "john@example.com",
            "status": "available"
        }
    ]
}
get/api/v1/contacts/{contact_id}/available-channels

Request

  • Base URL: https://api.sendseven.com
  • URL: https://api.sendseven.com/api/v1/contacts/{contact_id}/available-channels
  • Auth: HTTP bearer

Path parameters

contact_idstring required

Query parameters

for_user_idstring nullable

Filter email mailboxes by user access (internal user UUID). If not provided, automatically resolved from the authenticated user.

Response

Successful Response

contact_idstring required

Contact UUID

Changes

No recorded changes to this operation across all 3 revisions of this API.