# Intercom API Documentation

This is the complete API documentation for connecting to the Intercom API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **Intercom connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/intercom/actions/{actionSlug}/run
```

## Intercom actions

- PUT `archive-contact` Archive Contact
- PUT `attach-contact-to-conversation` Attach Contact To Conversation
- PUT `convert-conversation-to-ticket` Convert Conversation To Ticket
- POST `create-contact` Create Contact
- POST `create-conversation` Create Conversation
- POST `create-ticket` Create Ticket
- DELETE `delete-contact` Delete Contact
- DELETE `delete-conversation` Delete Conversation
- DELETE `delete-ticket` Delete Ticket
- GET `get-contact` Get Contact
- GET `get-contact-by-external-id` Get Contact By External ID
- GET `get-ticket` Get Ticket
- GET `list-contact-companies` List Contact Companies
- GET `list-contact-segments` List Contact Segments
- GET `list-contact-subscriptions` List Contact Subscriptions
- GET `list-contact-tags` List Contact Tags
- GET `list-contacts` List Contacts
- GET `list-conversations` List Conversations
- PUT `manage-conversation` Manage Conversation Part
- PUT `merge-contact` Merge Contact
- PUT `redact-conversation` Redact Conversation
- PUT `reply-conversation` Reply Conversation
- PUT `reply-ticket` Reply Ticket
- GET `retrieve-conversation` Retrieve Conversation
- GET `search-contacts` Search Contacts
- GET `search-conversations` Search Conversations
- GET `search-tickets` Search Tickets
- PUT `unarchive-contact` Unarchive Contact
- PUT `update-contact` Update Contact
- PUT `update-conversation` Update Conversation
- PUT `update-ticket` Update Ticket