All systems normalDashboardGet an API key
API reference / Connected sessions / Change username

Change username

Change your @username.

POSTapi.tikultra.com/v1/account/profile/usernamePremium · 25 credits
Upstream
/passport/login_name/update/
Access
Growth and up
Runs on
FullPool
Billing
Failed calls are free

Authorization & parameters

x-api-keyheader · stringrequired

Your API key. Create one in API keys.

Body

Send JSON with content-type: application/json.

account_idstringrequired

A connected account, from /dash/sessions or POST /v1/account/import. For example acc_7Hq2.

unique_idstringrequired

The new handle. For example acme_labs.

Client and egress

Executes on the dedicated FullPool mobile context and city-level egress bound to account_id. See Connected sessions.

Response

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining.

Response fields

Key top-level and nested fields decoded from the mobile upstream payload:

status_codeinteger

Upstream TikTok mobile status code (0 indicates success).

account_idstring

Connected session identifier bound to a dedicated FullPool mobile context.

previous_unique_idstring

Unique previous unique identifier.

unique_idstring

Public @username handle without the leading @.

updatedboolean

Whether updated is enabled or true.

next_change_allowed_atstring

ISO-8601 timestamp for next change allowed.

log_pbobject

Upstream request trace envelope from the mobile gateway.

log_pb.impr_idstring

Upstream TikTok impression / trace identifier.

Errors

Errors return a JSON body with a stable code and cost 0 credits. See Errors and retries.

Accounts you own only. Connected sessions are for accounts you own or are authorized to operate. Available on Growth and Scale.