{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"You can add participants who are contacts to a conversation, on behalf of either another contact or an admin.\n\n{% admonition type=\"warning\" name=\"Contacts without an email\" %}\nIf 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`.\n{% /admonition %}\n\n","properties":{"headers":{"type":"object","properties":{"Intercom-Version":{"$ref":"#/definitions/intercom_version","enum":["2.17"]}},"required":[],"additionalProperties":false},"path":{"type":"object","properties":{"conversation_id":{"type":"string","examples":["123"],"description":"The identifier for the conversation as given by Intercom."}},"required":["conversation_id"],"additionalProperties":false},"body":{"$ref":"#/definitions/attach_contact_to_conversation_request","examples":[{"admin_id":991267731,"customer":{"intercom_user_id":"6762f19b1bb69f9f2193bbd4"}}]}},"required":["path"],"additionalProperties":false,"definitions":{"intercom_version":{"description":"Intercom API version.</br>If you omit the header, the API uses the version set in your app package, and 1.0 if none is set.","type":"string","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","2.15","2.16","2.17"],"examples":["2.17"]},"attach_contact_to_conversation_request":{"title":"Attach Contact To Conversation Request","type":"object","description":"Payload of the request to add a contact to a conversation. Say who is adding the contact in one of two ways: send `admin_id` to act as an admin, or send one of `intercom_user_id`, `user_id` or `email` to act as a contact. Sending both, or neither, returns a `422` error. Use `customer` to identify the contact to add.","properties":{"admin_id":{"type":"string","description":"The `id` of the admin who is adding the new participant. Send this to act as an admin.","examples":["12345"]},"intercom_user_id":{"type":"string","description":"The identifier, as given by Intercom, of the contact who is adding the new participant. Send this, `user_id` or `email` to act as a contact.","examples":["6329bd9ffe4e2e91dac76188"]},"user_id":{"type":"string","description":"The `external_id` you have defined for the contact who is adding the new participant.","examples":["2e91dac761886329bd9ffe4e"]},"email":{"type":"string","description":"The email of the contact who is adding the new participant.","examples":["winstonsmith@truth.org"]},"customer":{"$ref":"#/definitions/customer_request"}},"required":["customer"]},"customer_request":{"type":["object","null"],"oneOf":[{"title":"Intercom User ID","properties":{"intercom_user_id":{"type":"string","description":"The identifier for the contact as given by Intercom.","examples":["6329bd9ffe4e2e91dac76188"]}},"required":["intercom_user_id"]},{"title":"User ID","properties":{"user_id":{"type":"string","description":"The external_id you have defined for the contact who is being added as a participant.","examples":["2e91dac761886329bd9ffe4e"]}},"required":["user_id"]},{"title":"Email","properties":{"email":{"type":"string","description":"The email you have defined for the contact who is being added as a participant.","examples":["sam.sung@example.com"]}},"required":["email"]}]}}},"name":"Attach a contact to a conversation","id":"intercom.attachcontacttoconversation","example":{"path":{"conversation_id":"123"}},"maxRequests":1,"summary":false}}