Use the Business API to create, update, retrieve, and delete departments in your Revolut Business account.
About departments
Departments let you organise your team members into groups within your business. You can assign team members to departments to reflect your organisational structure.
Each department has a name and a unique ID.
Manage departments via API
The Business API lets you:
- Create a department
- Retrieve a list of departments
- Retrieve a department
- Update a department
- Delete a department
Create a department
To create a new department, make a POST request providing the department name.
Department names must be unique within your business.
In the response, you get the ID of the created department.
To see example requests and responses:
See the API reference: Create a department
Retrieve a list of departments
You can list all the departments in your business.
The results are paginated using a page_token cursor.
Use the limit parameter to control the number of departments returned per page (maximum 500).
To get the next page, use the next_page_token from the previous response.
In the response, for each department you get its ID, name, and the date-times of creation and last update.
To see example requests and responses:
See the API reference: Retrieve a list of departments
Retrieve a department
To get details of a single department, make a GET request providing the department's ID.
To see example requests and responses:
See the API reference: Retrieve a department
Update a department
To update a department's name, make a PATCH request providing the department's ID and the new name.
Department names must be unique within your business.
To see example requests and responses:
See the API reference: Update a department
Delete a department
To delete a department, make a DELETE request providing the department's ID.
Deleting a department does not delete the team members assigned to it. The department assignment is simply removed from the team members.
To see example requests and responses:
See the API reference: Delete a department
What's next
See how to manage team members and assign them to departments.