# Chatous Join Match Queue API

> Join the Chatous matchmaking queue with your own account so it can be paired with another user. Takes your connect.sid session cookie and optional interest tags. Returns the queue entry id (pass it to chatous-dequeue to leave the queue) and whether an entry was already active. You can be matched with a real person as soon as the call succeeds.

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-enqueue.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-enqueue.post

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

## Request parameters

- `tags` (string) — Interest tags to match on, in Chatous's own format. Empty matches on nothing in particular.
- `proxyUrl` (string) — Optional proxy URL.
- `connectSid` (string, required) — The account's connect.sid cookie value.

## Response fields

- `queueId` (string, required) — The queue entry's id. Pass it to chatous-dequeue to release the entry. When `alreadyQueued` is true this is the id of the entry that BLOCKED this request, which may be a stranded one from an earlier session.
- `elapsedMs` (integer, required)
- `enqueuedAt` (string, required)
- `alreadyQueued` (boolean, required) — True when Chatous refused a second entry because one is already active. Not an error: the account is in the queue, just not because of this call.

## 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
{
  "tags": "",
  "connectSid": "example"
}
```

```json
{
  "queueId": "example",
  "elapsedMs": 1,
  "enqueuedAt": "example",
  "alreadyQueued": false
}
```

## Frequently asked questions

### How much does the Chatous Join Match Queue 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 Join Match Queue API?

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

### Are Chatous Join Match Queue API responses cached?

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

## More Social Media APIs

- [Chatous Leave Match Queue](https://upapi.io/apis/social-media/chatous-dequeue)
- [Chatous Login](https://upapi.io/apis/social-media/chatous-login)
- [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 Check Session](https://upapi.io/apis/social-media/chatous-check-session)
- [Chatous End Chat](https://upapi.io/apis/social-media/chatous-end-chat)