---
title: "POST /emails/"
method: POST
path: "/emails/"
tags: ["emails"]
---

# POST /emails/

`POST /emails/`

## Query parameters

- `format` 'json' | 'xlsx'

## Request body

- Email
  - `id` string, uuid, required
  - `url` string, uri, required
  - `account` string, uri, required
  - `external_id` string
  - `state` 'queued' | 'over_quota' | 'sent' | 'failed' | 'received', required
  - `notification` string, uri, required
  - `sender` string, uri, required
  - `from_email` string, email
  - `reply_to_email` string, email
  - `to_emails` string[]
  - `subject` string, required
  - `message` string, required
  - `sent_at` string, date-time, required
  - `failed_at` string, date-time, required
  - `received_at` string, date-time, required
  - `created_at` string, date-time, required

## Response `201`

## Changes

- **2026-07-13** `2557a8fec764` — 2 info
  - media type `application/json; version=2.4.12` was changed to `application/json; version=2.4.13` for the response status `201`
  - media type `application/xlsx; version=2.4.12` was changed to `application/xlsx; version=2.4.13` for the response status `201`
- **2022-10-13** `b89c1b3e6d09` — 2 info
  - media type `application/json; version=2.4.11` was changed to `application/json; version=2.4.12` for the response status `201`
  - media type `application/xlsx; version=2.4.11` was changed to `application/xlsx; version=2.4.12` for the response status `201`
- **2022-09-20** `2823b16250b7` — 2 info
  - media type `application/json; version=2.4.10` was changed to `application/json; version=2.4.11` for the response status `201`
  - media type `application/xlsx; version=2.4.10` was changed to `application/xlsx; version=2.4.11` for the response status `201`
- **2022-09-16** `025494408062` — 2 info
  - media type `application/json; version=2.4.5` was changed to `application/json; version=2.4.10` for the response status `201`
  - media type `application/xlsx; version=2.4.5` was changed to `application/xlsx; version=2.4.10` for the response status `201`
- **2022-09-08** `486e2fd12f8f` — 2 info
  - media type `application/json; version=2.3.5` was changed to `application/json; version=2.4.5` for the response status `201`
  - media type `application/xlsx; version=2.3.5` was changed to `application/xlsx; version=2.4.5` for the response status `201`

[Full history](https://skmtc.dev/oeklo/apis/gsmtasks-project-api/changes/emails/post.md)

---

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