# Chatous Send Message API

> Send a message into a Chatous chat from your own account. Takes your connect.sid session cookie, the chat id (from chatous-poll-events or chatous-get-account-state) and the message text, up to 2000 characters. Returns whether Chatous acknowledged the send. The message is delivered to the other person immediately.

Category: [Social Media APIs](https://upapi.io/apis/social-media) · Last updated 2026-11-07

## How to call it

- Endpoint: `POST https://api.upapi.io/chatous-send-message.post`, key in the `X-Api-Key` header, JSON body.
- Cost: 1 weighted unit per call.
- Timeout: 30 seconds.
- Cache: none; every call runs the operation.
- Try it without writing code: https://app.upapi.io/try/chatous-send-message.post

```bash
curl -X POST https://api.upapi.io/chatous-send-message.post \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "chatId": "example", "message": "example", "connectSid": "example" }'
```

## Request parameters

- `chatId` (string, required) — The chat to send into, from chatous-poll-events or -get-account-state.
- `message` (string, required) — The message text. It is delivered to a real person on Chatous.
- `proxyUrl` (string) — Optional proxy URL.
- `connectSid` (string, required) — The account's connect.sid cookie value.

## Response fields

- `sent` (boolean, required) — True only when Chatous acknowledged the message with return_code 0.
- `chatId` (string, required)
- `sentAt` (string, required)
- `elapsedMs` (integer, required)

## Example request and response

The example response is generated from the published output schema: it shows the shape and field names, not values from a recorded call.

```json
{
  "chatId": "example",
  "message": "example",
  "connectSid": "example"
}
```

```json
{
  "sent": false,
  "chatId": "example",
  "sentAt": "example",
  "elapsedMs": 1
}
```

## Frequently asked questions

### How much does the Chatous Send Message API cost per call?

Each call spends 1 weighted unit of your plan's monthly quota. Full pricing is at https://upapi.io/pricing.

### How do I authenticate to the Chatous Send Message API?

Send your key in the X-Api-Key header. A free guest key is available without creating an account.

### Are Chatous Send Message API responses cached?

No — every call runs the operation live; responses are not cached.

## More Social Media APIs

- [Chatous End Chat](https://upapi.io/apis/social-media/chatous-end-chat)
- [Chatous Update Profile](https://upapi.io/apis/social-media/chatous-update-profile)
- [Chatous Upload Profile Photo](https://upapi.io/apis/social-media/chatous-upload-profile-photo)
- [Chatous Check Session](https://upapi.io/apis/social-media/chatous-check-session)
- [Chatous Get Account State](https://upapi.io/apis/social-media/chatous-get-account-state)
- [Chatous Join Match Queue](https://upapi.io/apis/social-media/chatous-enqueue)
- [Chatous Leave Match Queue](https://upapi.io/apis/social-media/chatous-dequeue)
- [Chatous Login](https://upapi.io/apis/social-media/chatous-login)