---
title: "Creates a new Email Aero"
method: POST
path: "/api/{accountId}/v1/AeroEmails"
tags: ["AeroEmails"]
---

# Creates a new Email Aero

`POST /api/{accountId}/v1/AeroEmails`

## Request

- Base URL: `https://api.aeroworkflow.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.aeroworkflow.com/api/{accountId}/v1/AeroEmails`
- Auth: API key in header `apikey`

## Path parameters

- `accountId` string, required

## Request body

- AeroEmailCreate
  - `scheduledStartDate` string, date-time
  - `scheduledTotalHours` number, double
  - `scheduledHours` integer
  - `scheduledMinutes` integer
  - `assignedTo` string, required
  - `aeroType` string, required
  - `subject` string, required
  - `priority` 'elevated' | 'critical' | 'normal', required
  - `status` 'inprogress' | 'in progress' | 'notstarted' | 'not started' | 'canceled' | 'completed', required
  - `dueDate` string, date-time, nullable
  - `fullProjectName` string, nullable
  - `hat` string, nullable
  - `company` string, nullable
  - `contact` string, nullable
  - `description` string, nullable
  - `billable` boolean
  - `fixedFee` boolean
  - `comments` string, nullable
  - `body` string, nullable
  - `fromEmail` string, nullable
  - `bccEmail` string, nullable
  - `ccEmail` string, nullable
  - `toEmail` string, nullable
  - `incomingEmail` boolean

## Response `201`

Returns the created Email Aero

- AeroEmailRead
  - `id` integer
  - `scheduledStartDate` string, date-time
  - `scheduledDuration` string, date-span
  - `assignedTo` string, nullable, required
  - `aeroType` string, nullable, required
  - `subject` string, nullable, required
  - `dueDate` string, date-time, nullable
  - `projectId` integer, nullable
  - `project` string, nullable
  - `hat` string, nullable
  - `billable` boolean
  - `fixedFee` boolean
  - `priority` string, nullable, required
  - `status` string, nullable, required
  - `description` string, nullable
  - `body` string, nullable
  - `comments` string, nullable
  - `fromEmail` string, nullable
  - `toEmail` string, nullable
  - `ccEmail` string, nullable
  - `bccEmail` string, nullable
  - `emailType` string, nullable, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/aeroworkflow/apis/aero-api.md) · [All operations](https://skmtc.dev/aeroworkflow/apis/aero-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aeroworkflow/apis/aero-api/revisions/90ff1a2ccc16?raw)