# Follow Contra Profile API

> Follow a Contra profile from your own signed-in Contra account. Uses your own Contra account; upAPI stores nothing.

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

## How to call it

- Endpoint: `POST https://api.upapi.io/contra-follow-user.post`, key in the `X-Api-Key` header, JSON body.
- Cost: 6 weighted units per call.
- Timeout: 45 seconds.
- Cache: none; every call runs the operation.
- Try it without writing code: https://app.upapi.io/try/contra-follow-user.post

```bash
curl -X POST https://api.upapi.io/contra-follow-user.post \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "userProfileId": "example", "sessionCookies": {} }'
```

## Request parameters

- `docId` (string) — Override the pinned persisted-query id for this call.
- `proxyUrl` (string) — Exit IP pinned to this account. Omit to use the shared pool.
- `userProfileId` (string, required) — Contra UserProfile id to follow.
- `sessionCookies` (object, required) — Contra session cookies for the follower. Your own Contra account's cookies; upAPI stores nothing.

## Response fields

- `elapsedMs` (integer, required)
- `following` (boolean, required)
- `followedAt` (string, required)
- `userProfileId` (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
{
  "userProfileId": "example",
  "sessionCookies": {}
}
```

```json
{
  "elapsedMs": 1,
  "following": false,
  "followedAt": "example",
  "userProfileId": "example"
}
```

## Frequently asked questions

### How much does the Follow Contra Profile API cost per call?

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

### How do I authenticate to the Follow Contra Profile API?

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

### Are Follow Contra Profile API responses cached?

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

## More Social Media APIs

- [Unfollow Contra Profile](https://upapi.io/apis/social-media/contra-unfollow-user)
- [Get Contra Company Profile](https://upapi.io/apis/social-media/contra-company-profile)
- [Send Contra Message](https://upapi.io/apis/social-media/contra-send-message)
- [Apply To Contra Job](https://upapi.io/apis/social-media/contra-apply-to-job)
- [Get Contra Opportunity](https://upapi.io/apis/social-media/contra-job-detail)
- [List Contra Conversations](https://upapi.io/apis/social-media/contra-list-conversations)
- [List Contra Messages](https://upapi.io/apis/social-media/contra-list-messages)
- [Read Contra Job Feed](https://upapi.io/apis/social-media/contra-job-feed)