---
agentTools:
  projectIndex: https://developer.bill.com/llms.txt
---

# Setting user role information with users API endpoints

As a BILL partner, you can now set a user role when you create a user (`POST /v3/partner/users`) or update a user (`PATCH /v3/partner/users/\{userId}`).

You can set `roleId` as the BILL-generated ID of the user role you want to assign. You can get the list of available user roles with `GET /v3/partner/roles`. If you do not set `roleId` in your `POST /v3/partner/users` request, the default `ADMINISTRATOR` user role is assigned to the created user.

See [Users for BILL partners](https://developer.bill.com/v3/docs/partner-users) for more information.