---
title: "Add custom channel to a contact"
method: POST
path: "/orgs/contacts/{contact_id}/channels"
tags: ["Contacts"]
---

# Add custom channel to a contact

`POST /orgs/contacts/{contact_id}/channels`

## Request

- Base URL: `https://api.useinvent.com`
- URL: `https://api.useinvent.com/orgs/contacts/{contact_id}/channels`
- Auth: HTTP bearer

Add a new custom channel to an existing contact. At least one field (name, email, phone, or username) must be provided.

## Path parameters

- `contact_id` string, required

## Request body

- AddContactChannelSchema: Schema for adding a custom channel to an existing contact. At least one field must be provided.
  - `name` string, nullable: The name for the contact channel
  - `email` string, email, nullable: The email for the contact channel
  - `phone` string, nullable: The phone number for the contact channel
  - `username` string, nullable: The username for the contact channel

## Response `200`

- ContactChannelSchema: Schema for the contact channel
  - `id` string, required
  - `type` 'internal' | 'org' | 'agent' | 'custom' | 'whatsapp_bot' | 'messenger_bot' | 'instagram_dm' | 'tiktok_dm' | 'telegram_bot' | 'slack_bot' | 'teams_bot' | 'gmail' | 'outlook' | 'twilio' | 'telnyx' | 'email' | 'smpp', required: The channel type
  - `user_id` string, required: The unique identifier for the contact channel, e.g Phone Number or User ID
  - `avatar` string, nullable, required: The avatar for the contact channel, e.g X Avatar URL
  - `name` string, nullable, required: The name for the contact channel, e.g Full Name
  - `username` string, nullable, required: The username for the contact channel, e.g Username
  - `email` string, nullable, required: The email for the contact channel, e.g Email
  - `phone` string, nullable, required: The phone number for the contact channel, e.g Phone Number
  - `country` string, nullable, required: The country code associated with the contact channel, e.g US for United States
  - `agent` string, nullable, required: The user agent associated with the contact channel
  - `ip` string, nullable, required: The IP address associated with the contact channel
  - `language` string, nullable, required: The language code associated with the contact channel, e.g en for English
  - `link` string: A link to the contact channel, e.g a link to the social media profile
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

---

[API](https://skmtc.dev/useinvent/apis/invent-api.md) · [All operations](https://skmtc.dev/useinvent/apis/invent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useinvent/apis/invent-api/revisions/98824f3fde82?raw)