Submit X account email code

Free - does not consume credits

Use this endpoint after Connect X Account returns 202 Email Code Required. Submit the code from the account email inbox before expiresAt.

curl -X POST https://xquik.com/api/v1/x/account-connection-challenges/xch_8vGd8Y9JvH6dV0xA/submit \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{ "email_code": "123456" }' | 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.

Path Parameters

string

required

Challenge ID returned by Connect X Account.

Body

email_code

string

required

Email verification code for the pending connection. Codes from 4 to 64 characters are accepted. Spaces are stripped before submission.

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. 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 next 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"
}

The connection still needs a valid email code. Submit the new code to the same endpoint.

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

Missing email_code, invalid JSON, or a code outside the accepted length.

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

Missing or invalid API key.

{ "error": "connection_challenge_not_found", "message": "Connection challenge not found." }

The challenge ID does not exist or does not belong to the authenticated user.

{ "error": "connection_challenge_inactive", "message": "Connection challenge is no longer active." }

The challenge was already completed, failed, expired, or replaced.

{ "error": "connection_challenge_expired", "message": "Verification code expired. Start again." }

Start a new account connection to receive a fresh challenge.

{ "error": "login_failed", "message": "Login failed. Check credentials and try again." }

The code or account login state was rejected. Start a new connection if the account requires fresh credentials.

{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 }

Wait for the Retry-After header before retrying.

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

Retry after a short delay.

Related: Connect X Account starts the challenge, and List X Accounts verifies the account after connection.

Overview

X API

X Write

Trends

Radar

Account

API Keys

Credits

X Accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Submit X account email code

Headers

Path Parameters

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

​Path Parameters

​Body

​Response

Headers

Path Parameters

Body

Response