---
title: "Create virtual background"
method: POST
path: "/v2/company/virtual-backgrounds"
tags: ["Company"]
---

# Create virtual background

`POST /v2/company/virtual-backgrounds`

## Request

- Base URL: `https://api.sandbox.eu.bandyer.com`
- URL: `https://api.sandbox.eu.bandyer.com/v2/company/virtual-backgrounds`
- Auth: API key in header `apikey`

Create a new virtual background for a company.

## Request body `multipart/form-data`

- object
  - `virtual_background` string, binary: Virtual background file.

## Response `200`

- object
  - `background_alias` string: Virtual background identifier.
  - `url` string, url: Virtual background resource URL.
  - `creation_date` string, date-time: Creation date of the virtual background.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `422`: Unprocessable Content
- `429`: Too Many request

---

[API](https://skmtc.dev/kaleyra/apis/kaleyra-video-rest-api-v2.md) - [All operations](https://skmtc.dev/kaleyra/apis/kaleyra-video-rest-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/kaleyra/apis/kaleyra-video-rest-api-v2/revisions/4424fd54ae42?raw)