Page tree
Skip to end of metadata
Go to start of metadata

You can update a user's profile by sending the POST request with the XML data to the following URL: /user/<user_id>.

Permission to run the request: Account Owner, Administrator, Organization Administrator.

Request Headers

X-Auth-Account-Url(required)Base URL of the account, e.g.
X-Auth-Email (required)Administrator/Publisher e-mail address.
X-Auth-Password(required)Administrator/Publisher password.
X-Fields-Xml (required)An XML that contains the values of the user profile fields. For extended reference go to Getting User Profile Fields.
X-Organization-Id (optional)Organization ID to which a user will be moved.
X-Role (optional)

Assign a role to the new user:


X-Groups (optional)A list of group IDs to which a user will be added.

After the request has been completed, the system returns the reponse with Code 200. The reponse may include the X-Exceeded-Groups header, which contains a comma-separated list of group IDs, to which a user cannot be added.

Possible Response Codes

404Unknown userUserwith the specified ID was not found.
403Permission deniedYou have no permissions to update info of the specified user.
400Bad RequestThe system failed to process therequest,because it did not contain all necessary parameters.
400Invalid value <field_value>. Field <field_name> must be unique.Error appears if the 'user_fields' login and email have been changed. They should be unique.
200OkUser's profile has been updated.

Sample Request

POST /user/4 HTTP/1.1
X-Auth-Password: 1234
X-Fields-Xml: <fields><first_name>John</first_name><email></email>
X-Role: administrator
X-Groups: 4
X-Organization-Id: 1

Sample Response

HTTP/1.1 200 OK
Content-Length: 0
  • No labels