---
title: "Create a backup"
method: POST
path: "/backups"
tags: ["Backups"]
---

# Create a backup

`POST /backups`

This will initiate the creation of a backup. As with all POST endpoints, a location header will be returned for the new
backup item. You can query that endpoint to learn the status of the backup, and once it is completed to get its url.

## Request body

- object
  - `include_attachments` boolean — Whether to include attachments in the backup or not. Running a backup without attachments can greatly speed up the backup time. Defaults to false.
  - `include_emails` boolean — Whether to include emails in the backup or not. Running a backup without emails can greatly speed up the backup time. Defaults to true.

## Response `201`

Created

---

[API](https://skmtc.net/catsone/apis/cats-api-v3.md) · [All operations](https://skmtc.net/catsone/apis/cats-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/catsone/cats-api-v3/revisions/dedbbade450d/schema)