---
title: "Creates a new Company"
method: POST
path: "/api/{accountId}/v1/Companies"
tags: ["Companies"]
---

# Creates a new Company

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

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

## Path parameters

- `accountId` string, required

## Request body

- CompanyCreate
  - `name` string, required
  - `phone` string, nullable
  - `website` string, nullable
  - `accountNumber` string, nullable
  - `fax` string, nullable
  - `hourlyBillableRate` number, double, nullable
  - `monthlyFixedFee` number, double, nullable
  - `addressLine1` string, nullable
  - `addressLine2` string, nullable
  - `addressLine3` string, nullable
  - `addressCity` string, nullable
  - `addressState` string, nullable
  - `addressPostalCode` string, nullable
  - `addressCountry` string, nullable
  - `notes` string, nullable
  - `isLead` boolean
  - `defaultEmailAddress` string, nullable
  - `contactFirstName` string, nullable
  - `contactLastName` string, nullable

## Response `201`

Returns the created Company

- CompanyRead
  - `id` integer
  - `name` string, nullable, required
  - `accountingSoftware` string, nullable
  - `accountNumber` string, nullable
  - `phone` string, nullable
  - `fax` string, nullable
  - `hourlyBillableRate` number, double, nullable
  - `monthlyFixedFee` number, double, nullable
  - `defaultContact` string, nullable
  - `defaultEmailAddress` string, nullable
  - `companyType` string, nullable
  - `website` string, nullable
  - `addressLine1` string, nullable
  - `addressLine2` string, nullable
  - `addressLine3` string, nullable
  - `addressCity` string, nullable
  - `addressState` string, nullable
  - `addressPostalCode` string, nullable
  - `addressCountry` string, nullable
  - `notes` string, nullable
  - `active` boolean
  - `onHold` boolean

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