# Chatous Upload Profile Photo API

> Upload a profile photo to your Chatous account from an image URL or base64 bytes. Takes your connect.sid session cookie. Chatous limits uploads per exit IP rather than per account, so pass your own proxy URL if you upload from several accounts. Returns the uploaded size and filename.

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

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

## Request parameters

- `filename` (string) — Filename sent with the multipart part.
- `imageUrl` (string) — URL of the image to upload. Pass this OR `imageFile`.
- `proxyUrl` (string) — Optional proxy URL. Worth passing here more than anywhere else: Chatous rate-limits this endpoint PER EXIT IP, so accounts sharing an exit share one budget.
- `imageFile` (string) — Base64-encoded image bytes. Pass this OR `imageUrl`.
- `connectSid` (string, required) — The account's connect.sid cookie value.

## Response fields

- `filename` (string, required)
- `elapsedMs` (integer, required)
- `uploadedAt` (string, required)
- `uploadedBytes` (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
{
  "filename": "avatar.jpg",
  "connectSid": "example"
}
```

```json
{
  "filename": "example",
  "elapsedMs": 1,
  "uploadedAt": "example",
  "uploadedBytes": 1
}
```

## Frequently asked questions

### How much does the Chatous Upload Profile Photo 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 Upload Profile Photo API?

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

### Are Chatous Upload Profile Photo API responses cached?

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

## More Social Media APIs

- [Chatous Get Account State](https://upapi.io/apis/social-media/chatous-get-account-state)
- [Chatous Update Profile](https://upapi.io/apis/social-media/chatous-update-profile)
- [Chatous Check Session](https://upapi.io/apis/social-media/chatous-check-session)
- [Chatous End Chat](https://upapi.io/apis/social-media/chatous-end-chat)
- [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)
- [Chatous Poll Events](https://upapi.io/apis/social-media/chatous-poll-events)