# Give a role to many people

Queues the work of assigning a set of people the role named in the URL and returns
a token for the queued job. **Nothing is assigned by the time the response comes
back**, and the token is not something you can poll - confirm the outcome by
listing the role's members.
**Send the fields as form fields or in the query string, not as a JSON body.**
`selected` is read from the query and form data only, so a request carrying it as
JSON comes back as a `404` with nothing assigned.
A request whose fields are the right shape always returns a queue token, whether
or not the background work then succeeds: someone who belongs to another account,
already holds a role here, or would exceed the account's administrator limit is
skipped rather than reported.

Endpoint: POST /api/v2/account/role/{role_id}/user/mass-create
Version: 2.0.0
Security: default

## Path parameters:

  - `role_id` (integer, required)
    The ID of the role.

## Header parameters:

  - `Rosterfy-Platform` (string)

## Request fields (application/json):

  - `applyTo` (string, required)
    Must be sent, with the value selected. This endpoint only ever adds the people named in selected; no other value changes what it does.

  - `selected` (array, required)
    The people to add, as a list of user ids. A person who cannot be given the role - because they belong to a different account, or already hold a role in this one - is skipped rather than reported.

## Response 200 fields (application/json):

  - `queue` (string)