**Source URL:** https://general.veevavault.dev/vault-api/api-reference/26.1/document-binder-roles/binder-roles/assign-users-groups-to-roles-on-a-single-binder.md

# Assign Users & Groups to Roles on a Single Binder



<Aside>To assign users and groups to roles on multiple binders, use the [Assign Users & Groups to Roles on Multiple Documents & Binders](/vault-api/api-reference/26.1/document-binder-roles/document-roles/assign-users-groups-to-roles-on-multiple-documents-binders) endpoint.</Aside>
Assign users and groups to roles on a single binder.

<Endpoint path="/api/{version}/objects/binders/{binder_id}/roles" method="POST"></Endpoint>

## Headers {#headers}

| Name | Description |
| --- | --- |
| `Content-Type` | `application/x-www-form-urlencoded` |
| `Accept` | `application/json` (default) or `application/xml` |

## URI Path Parameters {#uri-path-parameters}

| Name | Description |
| --- | --- |
| `{binder_id}` | The binder `id` field value. |

## Body Parameters {#body-parameters}

| Name | Description |
| --- | --- |
| `{role__v}.users` | A string of comma-separated user id values for the new role. For example, `reviewer__v.users = "3003, 4005"`. |
| `{role__v}.groups` | A string of comma-separated group id values for the new group. For example, `reviewer__v.groups = "20, 21"`. |

## Request {#request}

<CodeExample title="">
```
curl -X POST -H "Authorization: {SESSION_ID}" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "consumer__v.users=35565,35571" \
-d "approver__v.users-45585,45594" \
https://myvault.veevavault.com/api/v25.1/objects/binders/245/roles

```
</CodeExample>

## Response {#response}

<CodeExample title="">
```
{
  "responseStatus": "SUCCESS",
  "responseMessage": "Roles updated",
  "updatedRoles": {
    "consumer__v": {
      "users": [
        19376,18234,19456
      ]
    },
    "legal__c": {
      "groups": [
        19365,18923
      ]
    }
  }
}

```
</CodeExample>

## Response Details {#response-details}

The response includes IDs of the users and groups successfully assigned to each role on the document.



---

**Previous:** [Retrieve Binder Role](/vault-api/api-reference/26.1/document-binder-roles/binder-roles/retrieve-binder-role)  
**Next:** [Remove Users & Groups from Roles on a Single Binder](/vault-api/api-reference/26.1/document-binder-roles/binder-roles/remove-users-groups-from-roles-on-a-single-binder)