Connect X account

Free - does not consume credits

Credentials are encrypted at rest and used only for maintaining the connection. Xquik never stores plaintext passwords.

curl -X POST https://xquik.com/api/v1/x/accounts \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "elonmusk",
    "email": "elon@example.com",
    "password": "s3cureP@ss",
    "totp_secret": "JBSWY3DPEHPK3PXP"
  }' | jq

Headers

x-api-key

string

required

Your API key. Session cookie authentication is also supported. Generate a key from the dashboard.

Content-Type

string

required

Must be application/json.

Body

username

string

required

X username to connect. The @ prefix is automatically stripped if included.

string

required

Email address associated with the X account.

password

string

required

Password for the X account. Encrypted at rest immediately upon receipt.

totp_secret

string

TOTP secret key for accounts with 2FA enabled. This is the base32-encoded secret (not the 6-digit code).

proxy_country

string

Preferred proxy region for the connection (e.g. "US", "TR").

Response

string

Unique account ID.

xUsername

string

Connected X username.

xUserId

string

X user ID.

status

string

Account connection status (e.g. "active").

health

string

Derived login/cookie health. One of healthy, locked, needsReauth, recovering, suspended, temporaryIssue. See Account health for meanings.

createdAt

string

ISO 8601 timestamp of when the account was connected.

Optional ISO 3166-1 alpha-2 country code (for example "US"). Present only when the declared proxy region was unavailable and login used a one-time US region. Future activity continues to use the selected proxy_country. Omitted on normal logins.

{
  "id": "3",
  "xUsername": "elonmusk",
  "xUserId": "44196397",
  "status": "active",
  "health": "healthy",
  "createdAt": "2026-02-20T08:15:00.000Z"
}

object

string

Always x_account_connection_challenge.

string

Challenge ID to submit with the email verification code.

status

string

Always requires_email_code.

expiresAt

string

ISO 8601 expiration time for the challenge.

message

string

Human-readable next step.

username

string

X username being connected.

{
  "object": "x_account_connection_challenge",
  "id": "xch_8vGd8Y9JvH6dV0xA",
  "status": "requires_email_code",
  "expiresAt": "2026-05-08T12:10:00Z",
  "message": "Enter the email verification code to continue.",
  "username": "elonmusk"
}

Submit the code to Submit X Account Email Code.

{ "error": "invalid_input", "message": "Invalid input. Check the request body." }

Missing username, email, or password, or invalid field format.

{ "error": "unauthenticated", "message": "Missing or invalid API key" }

Missing or invalid API key.

{ "error": "account_already_connected", "message": "This X account is already connected." }

The specified X account is already connected to your Xquik account.

{ "error": "rate_limit_exceeded", "message": "Too many connection attempts. Try again in 15 minutes.", "retryAfter": 900 }

You have exceeded the connection rate limit (3 per 15 minutes). The response includes a Retry-After: 900 header indicating how many seconds to wait before retrying. See the rate limits guide for details.

{ "error": "login_cooldown", "message": "Login is temporarily paused", "reason": "automated", "retryAfterMs": 3600000 }

A prior login attempt triggered a cooldown (for example, X flagged the session). Wait for retryAfterMs before retrying. The response includes a Retry-After header in seconds.

{ "error": "x_user_lookup_failed", "message": "X user not found. Check the username." }

The X username could not be resolved. Verify the handle is correct and that the account exists.

{ "error": "service_unavailable", "message": "Service temporarily unavailable. Try again." }

The X connection service is temporarily unavailable. Retry after a short delay.

Related: List X Accounts to see all connected accounts, or Re-authenticate if a session expires later.

Overview

X API

X Write

Trends

Radar

Account

API Keys

Credits

X Accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Connect X account

Headers

Body

Response

Overview

X API

X Write

Trends

Radar

Account

API Keys

Credits

X Accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Documentation Index

​Headers

​Body

​Response

Headers

Body

Response