Manage labels and label groups

Labels and label groups help you categorize and track your business spending for accounting purposes. You can apply these labels to financial records such as expenses to provide granular tracking, for example, for departments, projects, or locations.

Label considerations

• Hierarchy: Labels must always belong to a specific label group.
• Capacity: You can have up to 5 label groups per business at any time.
• Group limits: A single label group can contain up to 200 labels upon creation. More labels can be added later individually.
• Mutability: Externally managed labels and label groups cannot be modified via the API.

To manage label groups via the Business API, you must use an access token with the following scopes:

Operation	Required Scope
Retrieve label groups	READ
Create, update, or delete label groups	WRITE
Retrieve labels from a specific label group	READ
Create, update, or delete labels	WRITE

Note

The WRITE operations are not supported for externally managed labels and label groups.

Manage label groups​

Create a label group​

Note

This operation is not supported for externally managed label groups.

To add a new label group, you must provide the following details:

• Group name: A unique name for the label group that helps to understand its application.
• Labels: The list of labels to create with this group, provided as an array of label objects (max. 200), each with the following details:
  • Label name: The name of the label to create.

You must add at least one label. Empty label groups are not allowed.

Note

On success, the response returns only the ID of the created label group. To get all the details, use that ID to retrieve a specific label group.

For more details and sample requests and responses:

See the API reference: Create a label group

Tip

If you need to add more labels later, use the dedicated endpoint to create a label.

Retrieve label groups​

You can use the API to retrieve label groups available for your business.

When you retrieve the label groups, for each label group, you get its details, such as the label group ID and name, as well as when it was created and when it was last updated.

You can:

• Retrieve all the label groups available in your settings
• Retrieve a specific label group

Retrieve a list of label groups​

When you list all the label groups available for your business, the results are paginated and sorted by the created_at date in reverse chronological order. To get the next page of results, use the next_page_token value.

Note

The response returns only the group details (ID, name, dates of creation and latest update), and the next page token if available. It does not return the labels assigned to the group. To fetch the list of labels from a label group, use the dedicated endpoint.

For more details and sample requests and responses:

See the API reference: Retrieve a list of label groups

Retrieve a specific label group​

You can also retrieve a specific label group by its ID to look up its name, as well as dates of creation and last update.

Note

The response returns only the group details (ID, name, dates of creation and latest update). It does not return the labels assigned to the group. To fetch the list of labels from a label group, use the dedicated endpoint.

For more details and sample requests and responses:

See the API reference: Retrieve a label group

Update a label group​

Note

This operation is not supported for externally managed label groups.

You can use the PATCH request to update the name for a specific label group. This can be useful, for example, when there's a typing error in the name, or when the group name no longer accurately reflects the purpose.

Note

Batch updates for labels through label group settings are not supported. If you need to update the labels in a group, you can:

• Add a new label to the group
• Update the name for an existing label in the group
• Delete an existing label in the group

On successful update, you get a 204 response with no additional content.

For more details and sample requests and responses:

See the API reference: Update a label group

Delete a label group​

Note

This operation is not supported for externally managed label groups.

To delete a label group, simply make a DELETE call providing the ID of this label group.

Deletion consequences for financial records

Once a label group is deleted, it is removed from the Revolut Business app. Existing uncompleted records with labels from this label group will be marked as invalid, and you must manually update them to use active labels. Completed records are not affected.

On successful deletion, you get a 204 response with no additional content.

For more details and sample requests and responses:

See the API reference: Delete a label group

---

Manage labels​

Create a label​

Note

This operation is not supported for externally managed labels.

To add a new label, you must provide the following details:

Required details

• Group ID: The ID of the group in which to create the new label.
• Name: The unique name of the new label to create.

Note

On success, the response returns only the ID of the created label. To get all the details, retrieve labels from the label group.

For more details and sample requests and responses:

See the API reference: Create a label

Retrieve labels from a label group​

You can use the API to retrieve labels available for your business and belonging to a specific label group.

When you retrieve the labels, for each label, you get its details, such as the label ID and name, as well as when it was created and when it was last updated. The results are paginated and sorted by the created_at date in reverse chronological order. To get the next page of results, use the next_page_token value.

For more details and sample requests and responses:

See the API reference: Retrieve a list of labels

Update a label​

Note

This operation is not supported for externally managed labels.

You can use the PATCH request to update the name for a specific label. This can be useful, for example, when there's a typing error in the name, or when the label name no longer accurately reflects the purpose.

On successful update, you get a 204 response with no additional content.

For more details and sample requests and responses:

See the API reference: Update a label

Delete a label​

Note

This operation is not supported for externally managed labels.

To delete a label, simply make a DELETE call providing the ID of this label.

Deletion consequences for financial records

Once a label is deleted, it is removed from the Revolut Business app. Existing records with the deleted label that are pending completion will be marked as invalid, and they will require a manual update to a valid label. Complete records are not affected.

See an example of an incomplete expense with accounting settings that have been deleted, now marked as invalid →

On successful deletion, you get a 204 response with no additional content.

For more details and sample requests and responses:

See the API reference: Delete a label

---

Pagination​

• Page size: The API returns a maximum of 500 results per request (default: 100). You can increase or decrease the page size, i.e. the maximum number of results returned per page, by explicitly setting the limit parameter.
• Sorting: Results are sorted by the created_at date in reverse chronological order.
• Next Page: If the results exceed the page size, the response includes next_page_token. To fetch the next page of results, make a new request providing this value of next_page_token in the page_token query parameter.

Externally managed settings​

If an accounting software integration is connected, labels and label groups are typically managed within that external platform. In this state, the labels and label groups are read-only via the API, and manual modification attempts will return an error.

Tip

To find out if your labels are managed externally, check the Revolut Business settings.

1. Go to Settings → Accounting → Labels.
2. Look for a + New button above the labels.

• If you see the button, this means that your labels can be modified via the API.
• If you don't see the button, your labels are managed externally by the connected integration and cannot be modified (created/updated/deleted) via the API. The name of the connected integration appears near the top, together with information when it was last synced.

Editable	Read-only

See also​

• Accounting settings - overview
• Manage accounting categories
• Manage tax rates
• Revolut Help Centre: Expenses