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

# Creates a new Appointment Aero

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

## 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/AeroAppointments`
- Auth: API key in header `apikey`

## Path parameters

- `accountId` string, required

## Request body

- AeroAppointmentCreate
  - `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

## Response `201`

Returns the created Appointment Aero

- AeroAppointmentRead
  - `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
  - `description` string, nullable
  - `billable` boolean
  - `fixedFee` boolean
  - `priority` string, nullable, required
  - `status` string, nullable, required
  - `aeroSteps` AeroStepRead[], nullable, required
    - `id` integer
    - `order` string, nullable, required
    - `name` string, nullable
    - `description` string, nullable
    - `actionLink` string, nullable
    - `helpLink` string, nullable
    - `complete` string, nullable

## 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)