# Customers.ai API Documentation

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

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

## Customers.ai actions

- POST `create-contact` Create Contact
- GET `list-contact-ids` List Contact IDs
- GET `list-promoters` List Promoters
- POST `opt-in-sms-contact` Opt-In SMS Contact
- PUT `send-dialogue` Send Dialogue
- PUT `send-json-message` Send JSON Message
- PUT `update-contact` Update Contact