> This page is for Docs.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://zuora.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server.

# Assign the API user role to a user

> Learn how to assign the API user role to a user.

Learn how to assign the API user role to a user.

Ensure that a user role with the **API Write Access** is available in your tenant. See [Create an API user role](/docs/platform/security-and-identity/administrator-settings/manage-users/create-an-api-user/create-an-api-user-role).

The API user account must be used exclusively for API access. It is usually best to create a new user account specifically for this purpose and assign it the API user role.

Log in to Zuora as the tenant administrator.

Click the user name at the top right and click **Administration**.

On the Administration Settings page, click **Manage Users**.

On the All Users page, click **add single user** to create a new user, or click the name of an existing user to change that user's access.

Fill in the fields. We recommend using a name that suits the purpose, such as the name of your application, or "Dev" or "QA".

Select **API user** for the **Zuora Platform Role** option.

Configure the user setting as described in Platform roles .

Click **Save** to create the user.

All newly-created users are assigned a **Pending Active** status until they respond to the invitation email and create a password on the Zuora website. We recommend that your new API user open the password link in an Incognito window. Otherwise, you might experience cookie issues and might not be able to log in with another user easily.