# Chatous Login API

> Log in to your Chatous account with its email and password and return the connect.sid session cookie that every other Chatous operation needs. Treat the cookie as a credential: anyone holding it is the account. Pass a proxy URL to keep the session and its exit IP together.

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-login.post`, key in the `X-Api-Key` header, JSON body.
- Cost: 2 weighted units per call.
- Timeout: 45 seconds.
- Cache: none; every call runs the operation.
- Try it without writing code: https://app.upapi.io/try/chatous-login.post

```bash
curl -X POST https://api.upapi.io/chatous-login.post \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "email": "test@example.com", "password": "example" }'
```

## Request parameters

- `email` (string, required) — The account's email address. Chatous sends this as the `login` field.
- `password` (string, required) — The account's password.
- `proxyUrl` (string) — Optional proxy URL. Omit to call Chatous directly. Use the same one across related calls when you want the session and its exit IP to stay together.

## Response fields

- `elapsedMs` (integer, required)
- `connectSid` (string, required) — The session cookie every other Chatous operation needs. Store it as a credential: anyone holding it is this account.
- `loggedInAt` (string, 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
{
  "email": "test@example.com",
  "password": "example"
}
```

```json
{
  "elapsedMs": 1,
  "connectSid": "example",
  "loggedInAt": "example"
}
```

## Frequently asked questions

### How much does the Chatous Login API cost per call?

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

### How do I authenticate to the Chatous Login API?

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

### Are Chatous Login API responses cached?

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

## More Social Media APIs

- [Chatous Check Session](https://upapi.io/apis/social-media/chatous-check-session)
- [Chatous Poll Events](https://upapi.io/apis/social-media/chatous-poll-events)
- [Chatous Send Message](https://upapi.io/apis/social-media/chatous-send-message)
- [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 End Chat](https://upapi.io/apis/social-media/chatous-end-chat)
- [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)