---
api: 'Business API'
---

# Create a new label group

Add a new group of labels that can be applied to your financial records, such as expenses.

:::note
- This operation is not supported for [externally managed label groups](/docs/guides/manage-accounts/accounting/manage-labels-and-label-groups#externally-managed-settings).
- You can have up to 5 label groups at a time per business.
:::

For more details, see the guides: [Manage accounting settings](/docs/guides/manage-accounts/accounting/manage-accounting-settings) and [Manage labels and label groups](/docs/guides/manage-accounts/accounting/manage-labels-and-label-groups).

## Endpoint

POST `/label-groups`

## Request body

### Attributes

- `name` (string)
    The name for the new label group.
- `labels` (array of object)
    The labels to create in the new group.
    
    The maximum number of labels you can create for a new group is 200.
    If you need to add more, you can add them later by [creating new labels individually](/docs/api/business#create-label).
  - `labels[].name` (string)
      The name for the new label.

## Returns

### 201

Resource created

On successful creation, the response returns only the ID of the new resource (i.e. the label group), even if the resource has more properties.
To get all the details of the label group, use the returned resource ID with a [GET request](/docs/api/business#get-label-group).

#### Response attributes

- `id` (string, optional)
    The ID of the created resource.

## Error responses

| HTTP status code | Description |
| --- | --- |
| 400 | Bad Request  Returned, for example, when a required parameter is missing or malformatted. |
| 401 | Unauthorized – authentication credentials are missing or invalid  Returned when the request was not fulfilled because authentication has failed or has not been provided. |
| 403 | Action forbidden - insufficient permissions to perform this action  Returned, for example, when you don't have permissions necessary to perform this action. |
| 409 | Conflict  Request conflicts with the current state of the resource. Returned, for example, when a label group with the provided name already exists. |
| 422 | Unprocessable entity - label group cannot be created due to business rules   Returned, for example, when you have an accounting software integration connected to your Revolut Business account, and labels are managed by that integration.  The request is well-formed and the server understands it, but the operation cannot be performed because the resource state doesn't permit it. Retrying the same request won't succeed. |
| 429 | Too many requests  Returned, for example, when the rate limit has been exceeded. If the response includes the `Retry-After` instruction, please respect it and refrain from earlier retry attempts. |
| 500 | Internal server error  An unexpected application error occurred. |
| 503 | Service Unavailable  The system is temporarily unavailable. If the response includes the `Retry-After` header instruction, please respect it and refrain from earlier retry attempts. |