Update Customer Username

This endpoint is used to update the username of the currently authenticated customer. To perform the update, a valid email address must be provided as part of the request to ensure ownership and verification.

Use this endpoint when a customer needs to change their existing username — for example, after an email change, rebranding, or correcting a previous entry.

This ensures that each customer's username remains unique and tied to their verified email identity.

Authorization: Bearer YOUR_TOKEN

Expected Behavior:

On success, the username will be updated, and a message will confirm that verification is required. To complete the process, you need to verify the new username using the Confirm Customer Username Change endpoint.
If the request is unauthorized or invalid, the system will respond with an error message.

Request Body Parameters

email string
The email address to be associated with the customer's username. Example: 'pinghome@gmail.com'

ResponseThis section is used to view the possible HTTP response codes returned by the API. These codes indicate the status of a request, such as 201 (Created), 401 (Unauthorized), 409 (Conflict), or 422 (Unprocessable Entity).

Update Customer Username

Authorization: Bearer YOUR_TOKEN

Expected Behavior:

On success, the username will be updated, and a message will confirm that verification is required. To complete the process, you need to verify the new username using the Confirm Customer Username Change endpoint.
If the request is unauthorized or invalid, the system will respond with an error message.

Request Body Parameters

email string
The email address to be associated with the customer's username. Example: 'pinghome@gmail.com'

curl -X PUT "https://api.pinghome.io/customer-cmd/v1/customer/username" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
--data '{
  "email": "pinghome@gmail.com"
}'