# Social Intents API Documentation

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

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

## Social Intents actions

- POST `create-chat-completed-webhook` Create Chat Completed Webhook
- POST `create-lead-captured-webhook` Create Lead Captured Webhook
- POST `create-offline-message-webhook` Create Offline Message Webhook
- DELETE `delete-webhook` Delete Webhook
- DELETE `delete-widget-webhook` Delete Widget Webhook
- GET `get-chat-by-id` Get Chat By ID
- GET `get-offline-message-by-id` Get Offline Message By ID
- GET `list-chats` List Chats
- GET `list-chats-by-date-range` List Chats By Date Range
- GET `list-chats-by-email` List Chats By Email
- GET `list-chats-by-timezone` List Chats By Timezone
- GET `list-chats-by-visitor` List Chats By Visitor
- GET `list-chats-by-widget` List Chats By Widget
- GET `list-contacts-leads` List Contacts / Leads
- GET `list-contacts-by-date-range` List Contacts By Date Range
- GET `list-contacts-by-timezone` List Contacts By Timezone
- GET `list-contacts-by-widget` List Contacts By Widget
- GET `list-missed-chats` List Missed Chats
- GET `list-missed-chats-by-date-range` List Missed Chats By Date Range
- GET `list-missed-chats-by-email` List Missed Chats By Email
- GET `list-missed-chats-by-timezone` List Missed Chats By Timezone
- GET `list-missed-chats-by-visitor` List Missed Chats By Visitor
- GET `list-missed-chats-by-widget` List Missed Chats By Widget
- GET `list-offline-messages` List Offline Messages
- GET `list-offline-messages-by-date-range` List Offline Messages By Date Range
- GET `list-offline-messages-by-email` List Offline Messages By Email
- GET `list-offline-messages-by-timezone` List Offline Messages By Timezone
- GET `list-offline-messages-by-visitor` List Offline Messages By Visitor
- GET `list-offline-messages-by-widget` List Offline Messages By Widget
- GET `list-widgets` List Widgets
- GET `ping-api` Ping API