Contacts

Add custom channel to a contact

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

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

Path parameters

contact_idstring required

Contact ID

Request body

namestring nullable

The name for the contact channel

emailstring email nullable

The email for the contact channel

phonestring nullable

The phone number for the contact channel

usernamestring nullable

The username for the contact channel

Response

idstring 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_idstring required

The unique identifier for the contact channel, e.g Phone Number or User ID

avatarstring nullable required

The avatar for the contact channel, e.g X Avatar URL

namestring nullable required

The name for the contact channel, e.g Full Name

usernamestring nullable required

The username for the contact channel, e.g Username

emailstring nullable required

The email for the contact channel, e.g Email

phonestring nullable required

The phone number for the contact channel, e.g Phone Number

countrystring nullable required

The country code associated with the contact channel, e.g US for United States

agentstring nullable required

The user agent associated with the contact channel

ipstring nullable required

The IP address associated with the contact channel

languagestring nullable required

The language code associated with the contact channel, e.g en for English

linkstring

A link to the contact channel, e.g a link to the social media profile

created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.