**Source URL:** https://general.veevavault.dev/vault-api/api-reference/26.1/groups/create-group.md

# Create Group



<Endpoint path="/api/{version}/objects/groups" method="POST"></Endpoint>

## Headers {#headers}

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

## Body Parameters {#body-parameters}

<FieldTable>
| Name | Description |
| --- | --- |
| `label__v` | Enter a group label. Vault uses this to create the group `name__v` value. |
| `members__v` | Add a comma-separated list of user IDs. This manually assigns individual users to the group. |
| `security_profiles__v` | Add a comma-separated list of security profiles. This automatically adds all users with the security profile to the group. These are `implied_members__v`. |
| `active__v` | By default, the new group will be created as active. To set the group to inactive, set this value to `false` |
| `group_description__v` | Add a description of the group. |
| `allow_delegation_among_members__v` | When set to `true`, members of this group will only be allowed to delegate access to other members of the same group. You can set this field for user and system managed groups. If omitted, defaults to `false`. Learn more about [Delegate Access](https://platform.veevavault.help/en/gr/15015). |
</FieldTable>

## Request {#request}

<CodeExample title="">
```
curl -X POST -H "Authorization: {SESSION_ID}" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "label__v=Cholecap Team US Compliance" \
-d "members__v=45501,45002" \
-d "security_profiles__v=document_user__v"
https://myvault.veevavault.com/api/v15.0/objects/groups

```
</CodeExample>

## Response {#response}

<CodeExample title="">
```
{
  "responseStatus": "SUCCESS",
  "responseMessage": "Group successfully created.",
  "id": 1358979070034
}

```
</CodeExample>

---

**Previous:** [Retrieve Group](/vault-api/api-reference/26.1/groups/retrieve-group)  
**Next:** [Update Group](/vault-api/api-reference/26.1/groups/update-group)