# Detach a contact from a group conversation You can add participants who are contacts to a conversation, on behalf of either another contact or an admin. {% admonition type="warning" name="Contacts without an email" %} If you add a contact via the email parameter and there is no user/lead found on that workspace with he given email, then we will create a new contact with role set to lead. {% /admonition %} Endpoint: DELETE /conversations/{conversation_id}/customers/{contact_id} Version: Preview Security: bearerAuth ## Header parameters: - `Intercom-Version` (string) Intercom API version.By default, it's equal to the version set in the app package. Enum: "1.0", "1.1", "1.2", "1.3", "1.4", "2.0", "2.1", "2.2", "2.3", "2.4", "2.5", "2.6", "2.7", "2.8", "2.9", "2.10", "2.11", "2.12", "2.13", "2.14", "Preview" ## Path parameters: - `conversation_id` (string, required) The identifier for the conversation as given by Intercom. Example: "123" - `contact_id` (string, required) The identifier for the contact as given by Intercom. Example: "123" ## Request fields (application/json): - `admin_id` (string, required) The id of the admin who is performing the action. Example: "5017690" ## Response 200 fields (application/json): - `type` (string) Always conversation. Example: "conversation" - `id` (string) The id representing the conversation. Example: "1295" - `title` (string,null) The title given to the conversation. Example: "Conversation Title" - `created_at` (integer) The time the conversation was created. Example: 1663597223 - `updated_at` (integer) The last time the conversation was updated. Example: 1663597260 - `waiting_since` (integer,null) The last time a Contact responded to an Admin. In other words, the time a customer started waiting for a response. Set to null if last reply is from an Admin. Example: 1663597260 - `snoozed_until` (integer,null) If set this is the time in the future when this conversation will be marked as open. i.e. it will be in a snoozed state until this time. i.e. it will be in a snoozed state until this time. Example: 1663597260 - `open` (boolean) Indicates whether a conversation is open (true) or closed (false). Example: true - `state` (string) Can be set to "open", "closed" or "snoozed". Enum: "open", "closed", "snoozed" - `read` (boolean) Indicates whether a conversation has been read. Example: true - `priority` (string) If marked as priority, it will return priority or else not_priority. Enum: "priority", "not_priority" - `admin_assignee_id` (integer,null) The id of the admin assigned to the conversation. If it's not assigned to an admin it will return null. - `team_assignee_id` (string,null) The id of the team assigned to the conversation. If it's not assigned to a team it will return null. Example: "5017691" - `company` (object) Companies allow you to represent organizations using your product. Each company will have its own description and be associated with contacts. You can fetch, create, update and list companies. - `company.type` (string) Value is company Enum: "company" - `company.id` (string) The Intercom defined id representing the company. Example: "531ee472cce572a6ec000006" - `company.name` (string) The name of the company. Example: "Blue Sun" - `company.app_id` (string) The Intercom defined code of the workspace the company is associated to. Example: "ecahpwf5" - `company.plan` (object) - `company.plan.type` (string) Value is always "plan" Example: "plan" - `company.plan.id` (string) The id of the plan Example: "269315" - `company.plan.name` (string) The name of the plan Example: "Pro" - `company.company_id` (string) The company id you have defined for the company. Example: "6" - `company.remote_created_at` (integer) The time the company was created by you. Example: 1663597223 - `company.created_at` (integer) The time the company was added in Intercom. Example: 1663597223 - `company.updated_at` (integer) The last time the company was updated. Example: 1663597223 - `company.last_request_at` (integer) The time the company last recorded making a request. Example: 1663597223 - `company.size` (integer) The number of employees in the company. Example: 100 - `company.website` (string) The URL for the company website. Example: "https://www.intercom.com" - `company.industry` (string) The industry that the company operates in. Example: "Software" - `company.monthly_spend` (integer) How much revenue the company generates for your business. Example: 100 - `company.session_count` (integer) How many sessions the company has recorded. Example: 100 - `company.user_count` (integer) The number of users in the company. Example: 100 - `company.custom_attributes` (object) The custom attributes you have set on the company. Example: {"paid_subscriber":true,"monthly_spend":155.5,"team_mates":9} - `company.tags` (object) The list of tags associated with the company - `company.tags.type` (string) The type of the object Enum: "tag.list" - `company.tags.tags` (array) - `company.tags.tags.type` (string) value is "tag" Example: "tag" - `company.tags.tags.id` (string) The id of the tag Example: "123456" - `company.tags.tags.name` (string) The name of the tag Example: "Test tag" - `company.segments` (object) The list of segments associated with the company - `company.segments.segments` (array) - `company.segments.segments.type` (string) The type of object. Enum: "segment" - `company.segments.segments.id` (string) The unique identifier representing the segment. Example: "56203d253cba154d39010062" - `company.segments.segments.name` (string) The name of the segment. Example: "Active" - `company.segments.segments.created_at` (integer) The time the segment was created. Example: 1394621988 - `company.segments.segments.updated_at` (integer) The time the segment was updated. Example: 1394622004 - `company.segments.segments.person_type` (string) Type of the contact: contact (lead) or user. Enum: "contact", "user" - `company.segments.segments.count` (integer,null) The number of items in the user segment. It's returned when include_count=true is included in the request. Example: 3 - `company.notes` (object) The list of notes associated with the company - `company.notes.notes` (array) - `company.notes.notes.type` (string) String representing the object's type. Always has the value note. Example: "note" - `company.notes.notes.id` (string) The id of the note. Example: "17495962" - `company.notes.notes.created_at` (integer) The time the note was created. Example: 1674589321 - `company.notes.notes.company` (object,null) Represents the company that the note was created about. - `company.notes.notes.company.type` (string) String representing the object's type. Always has the value company. Example: "company" - `company.notes.notes.company.id` (string) The id of the company. Example: "6329bd9ffe4e2e91dac76188" - `company.notes.notes.author` (object,null) Admins are teammate accounts that have access to a workspace. - `company.notes.notes.author.type` (string) String representing the object's type. Always has the value admin. Example: "admin" - `company.notes.notes.author.id` (string) The id representing the admin. Example: "1295" - `company.notes.notes.author.name` (string) The name of the admin. Example: "Joe Example" - `company.notes.notes.author.email` (string) The email of the admin. Example: "jdoe@example.com" - `company.notes.notes.author.job_title` (string) The job title of the admin. Example: "Associate" - `company.notes.notes.author.away_mode_enabled` (boolean) Identifies if this admin is currently set in away mode. - `company.notes.notes.author.away_mode_reassign` (boolean) Identifies if this admin is set to automatically reassign new conversations to the apps default inbox. - `company.notes.notes.author.away_status_reason_id` (integer,null) The unique identifier of the away status reason Example: 12345 - `company.notes.notes.author.has_inbox_seat` (boolean) Identifies if this admin has a paid inbox seat to restrict/allow features that require them. Example: true - `company.notes.notes.author.team_ids` (array) This object represents the avatar associated with the admin. Example: [814865] - `company.notes.notes.author.avatar` (string,null) Image for the associated team or teammate Example: "https://picsum.photos/200/300" - `company.notes.notes.author.team_priority_level` (object,null) Admin priority levels for teams - `company.notes.notes.author.team_priority_level.primary_team_ids` (array,null) The primary team ids for the team Example: [814865] - `company.notes.notes.author.team_priority_level.secondary_team_ids` (array,null) The secondary team ids for the team Example: [493881] - `company.notes.notes.author.role` (object,null) The role assigned to this admin. Only present if the admin has a role assigned. - `company.notes.notes.author.role.type` (string) String representing the object's type. Always has the value role. Example: "role" - `company.notes.notes.author.role.id` (string) The id of the role. Example: "1" - `company.notes.notes.author.role.name` (string) The name of the role. Example: "Support Agent" - `company.notes.notes.body` (string) The body text of the note. Example: "
Text for the note.
" - `tags` (object) A list of tags objects associated with a conversation - `tags.tags` (array) A list of tags objects associated with the conversation. - `tags.tags.applied_at` (integer,null) The time when the tag was applied to the object Example: 1663597223 - `tags.tags.applied_by` (object,null) The admin who applied the tag - `tags.tags.applied_by.type` (string) Example: "contact" - `tags.tags.applied_by.id` (string,null) Example: "1a2b3c" - `conversation_rating` (object,null) The Conversation Rating object which contains information on the rating and/or remark added by a Contact and the Admin assigned to the conversation. - `conversation_rating.rating` (integer) The rating, between 1 and 5, for the conversation. Example: 5 - `conversation_rating.remark` (string) An optional field to add a remark to correspond to the number rating - `conversation_rating.created_at` (integer) The time the rating was requested in the conversation being rated. Example: 1671028894 - `conversation_rating.updated_at` (integer) The time the rating was last updated. Example: 1671028894 - `conversation_rating.contact` (object) reference to contact object - `conversation_rating.contact.type` (string) always contact Enum: "contact" - `conversation_rating.contact.id` (string) The unique identifier for the contact which is given by Intercom. Example: "5ba682d23d7cf92bef87bfd4" - `conversation_rating.contact.external_id` (string,null) The unique identifier for the contact which is provided by the Client. Example: "70" - `conversation_rating.teammate` (object) reference to another object - `source` (object) The type of the conversation part that started this conversation. Can be Contact, Admin, Campaign, Automated or Operator initiated. - `source.type` (string) This includes conversation, email, facebook, instagram, phone_call, phone_switch, push, sms, twitter and whatsapp. Enum: "conversation", "email", "facebook", "instagram", "phone_call", "phone_switch", "push", "sms", "twitter", "whatsapp" - `source.id` (string) The id representing the message. Example: "3" - `source.delivered_as` (string) The conversation's initiation type. Possible values are customer_initiated, campaigns_initiated (legacy campaigns), operator_initiated (Custom bot), automated (Series and other outbounds with dynamic audience message) and admin_initiated (fixed audience message, ticket initiated by an admin, group email). Example: "operator_initiated" - `source.subject` (string) Optional. The message subject. For Twitter, this will show a generic message regarding why the subject is obscured. - `source.body` (string) The message body, which may contain HTML. For Twitter, this will show a generic message regarding why the body is obscured. Example: "Hey there!
" - `source.author` (object) The object who initiated the conversation, which can be a Contact, Admin or Team. Bots and campaigns send messages on behalf of Admins or Teams. For Twitter, this will be blank. - `source.author.type` (string) The type of the author Example: "admin" - `source.author.id` (string) The id of the author Example: "274" - `source.author.name` (string,null) The name of the author Example: "Operator" - `source.author.email` (string) The email of the author Example: "operator+abcd1234@intercom.io" - `source.author.from_ai_agent` (boolean) If this conversation part was sent by the AI Agent Example: true - `source.author.is_ai_answer` (boolean) If this conversation part body was generated by the AI Agent - `source.attachments` (array) A list of attachments for the part. - `source.attachments.type` (string) The type of attachment Example: "upload" - `source.attachments.name` (string) The name of the attachment Example: "example.png" - `source.attachments.url` (string) The URL of the attachment Example: "https://picsum.photos/200/300" - `source.attachments.content_type` (string) The content type of the attachment Example: "image/png" - `source.attachments.filesize` (integer) The size of the attachment Example: 100 - `source.attachments.width` (integer) The width of the attachment Example: 100 - `source.attachments.height` (integer) The height of the attachment Example: 100 - `source.url` (string,null) The URL where the conversation was started. For Twitter, Email, and Bots, this will be blank. - `source.redacted` (boolean) Whether or not the source message has been redacted. Only applicable for contact initiated messages. - `source.email_message_metadata` (object) Contains metadata if the message was sent as an email - `source.email_message_metadata.message_id` (string,null) The unique identifier for the email message as specified in the Message-ID header Example: "Previous thread