---
title: "POST /twitter/user_login_v3"
method: POST
path: "/twitter/user_login_v3"
---

# POST /twitter/user_login_v3

`POST /twitter/user_login_v3`

## Request

- Base URL: `https://api.twitterapi.io`
- URL: `https://api.twitterapi.io/twitter/user_login_v3`
- Auth: API key in header `X-API-Key`

V3 Login API - Log in using your email, username, password, and 2FA code. This is an asynchronous login method. After calling this API, the system will process your login request in the background. You can call get_my_x_account_detail_v3 to check the login status. Price: 500 credits ($0.005 per call).

## Request body

- object
  - `user_name` string, required: Twitter username. Must be set.
  - `email` string: Email address associated with the account. Must be set if cookie is empty..
  - `password` string: The password of the user. Must be set if cookie is empty.
  - `totp_code` string: The TOTP secret key for 2FA authentication. It is a 10-character string, not a number! If your account has 2FA enabled, this field is required for successful login.
  - `cookie` string: Optional. Pre-existing cookie string in format 'cto=xx&auth_token='. Can be used to resume a previous session.
  - `proxy` string, required: The proxy to use. **Must** use high-quality residential proxies and avoid free proxies.Otherwise, you will fail 100%. Required. Example: http://username:password@ip:port . You can get proxy from: https://www.webshare.io/?referral_code=4e0q1n00a504

## Response `200`

Login response

- object
  - `status` string: Status of the request. 'success' means the login request has been accepted and is being processed.
  - `msg` string: Message describing the current state. For example: 'Add done.configing.' means the login is being configured.
  - `login_cookie` string: The login cookie of the user. This will be returned once the login is complete. Use this cookie to post tweets, etc.

## Other responses

- `400`: Unexpected error

## Changes

- **2026-11-03** `03599c7e3236`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/twitterapi/apis/twitterapi-io-the-most-stable-fastest-cheapest-twitter-api/changes/twitter/user_login_v3/post.md)

---

[API](https://skmtc.dev/twitterapi/apis/twitterapi-io-the-most-stable-fastest-cheapest-twitter-api.md) - [All operations](https://skmtc.dev/twitterapi/apis/twitterapi-io-the-most-stable-fastest-cheapest-twitter-api/llms.txt) - [OpenAPI document](https://skmtc.dev/twitterapi/apis/twitterapi-io-the-most-stable-fastest-cheapest-twitter-api/revisions/03599c7e3236?raw)