# respond.io API Documentation

This is the complete API documentation for connecting to the respond.io 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 **respond.io connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

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

## respond.io actions

- POST `add-tags` Add Tags
- PUT `assign-or-unassign-conversation` Assign Or Unassign Conversation
- POST `create-contact` Create Contact
- POST `create-custom-field` Create Custom Field
- PUT `create-or-update-contact` Create Or Update Contact
- POST `create-space-tag` Create Space Tag
- DELETE `delete-contact` Delete Contact
- DELETE `delete-space-tag` Delete Space Tag
- DELETE `delete-tags` Delete Tags
- GET `get-contact` Get Contact
- GET `get-custom-field` Get Custom Field
- GET `get-user` Get User
- GET `list-channels` List Channels
- GET `list-closing-notes` List Closing Notes
- GET `list-contact-channels` List Contact Channels
- GET `list-contacts` List Contacts
- GET `list-custom-fields` List Custom Fields
- GET `list-message-templates` List Message Templates
- GET `list-users` List Users
- PUT `merge-contacts` Merge Contacts
- PUT `open-or-close-conversation` Open Or Close Conversation
- PUT `update-contact` Update Contact
- PUT `update-contact-lifecycle` Update Contact Lifecycle
- PUT `update-space-tag` Update Space Tag