---
title: "Import email"
method: POST
path: "/api/v1/emails/import"
tags: ["Email"]
---

# Import email

`POST /api/v1/emails/import`

Import an email as raw data. Calling this endpoint starts an asynchronous process of creating
an email object and importing its contents to the specified recipient inbox in Rossum. This endpoint
can be used only by `admin` and `organization_group_admin` roles and email can be imported only to
inboxes within the organization. The caller of this endpoint will be specified as the `creator` of the email.
The email sender specified in the `from` header will still receive any automated notifications targeted to the
email recipients.

Import email endpoint is asynchronous and response contains created task
url. Further information about the import status may be acquired by retrieving
the email object or the task (for more information, please refer to [task](/api/task).

## Response `202`

Accepted

- object
  - `url` string, uri — URL of the created [task](/api/task)

## Other responses

- `400` — Invalid input data.
- `401` — The username/password is invalid or token is invalid (e.g. expired).
- `403` — Insufficient permission, missing authentication, invalid CSRF token and similar issue.
- `404` — The specified resource was not found.
- `409` — Conflict
- `413` — Payload too large (especially for files uploaded).
- `429` — Request rate is too high, wait before sending more requests. See [Rate Limiting](/guides/overview#rate-limiting) for more details.
- `500` — Server failure while processing the request.
- `502` — Invalid response from the upstream server.
- `503` — We're temporarily offline for maintenance. Please try again later.
- `504` — Upstream server could not complete the request in time.

---

[API](https://skmtc.dev/rossum/apis/rossum-api.md) · [All operations](https://skmtc.dev/rossum/apis/rossum-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rossum/rossum-api/revisions/f1b5a910991d/schema)