---
search:
  tags:
    - Twitter Profile Actions Endpoints
    - POST
seo:
  description: >-
    Change the @username (screen name) of the account identified by cookie.
    TwexAPI… Reference for POST /twitter/profile/username in the TwexAPI X
    (Twitter) API.
  title: Change Username – X (Twitter) API endpoint
sidebar:
  badge: POST
  label: Change Username
title: Change Username
type: openapi-operation
---
Change the @username (screen name) of the account identified by `cookie`. TwexAPI first asks X whether the new handle is available: a handle that is already taken returns 409, and one X will not accept (too short, reserved, not allowed) returns 400 with X's reason, without changing anything. On success it returns the username X saved. To change the display name, use `POST /twitter/profile` instead. Requires a TwexAPI Bearer key and the account's authorized X cookie or auth_token.

<Operation source="api-reference" id="change-username" />
