---
title: "Creates a new customer company record in Avaza."
method: POST
path: "/api/Company"
tags: ["Company"]
---

# Creates a new customer company record in Avaza.

`POST /api/Company`

## Request body

- NewCompany — Request model for creating a new customer company.
  - `CompanyName` string, required — The name of the company. Required.
  - `CurrencyCode` string — The default currency code for this company. Defaults to the account's default currency if not provided.
  - `BillingAddressLine` string — The street address line for the company's billing address.
  - `BillingAddressCity` string — The city for the company's billing address.
  - `BillingAddressState` string — The state or province for the company's billing address.
  - `BillingAddressPostCode` string — The postcode or ZIP code for the company's billing address.
  - `BillingCountryCode` string — The ISO 2-letter country code for the company's billing address.
  - `BillingAddress` string — The full formatted billing address string. If set, overrides the individual address fields.
  - `Phone` string — The company's primary phone number.
  - `Fax` string — The company's fax number.
  - `website` string — The company's website URL.
  - `TaxNumber` string — The company's tax registration number.
  - `Comments` string — Internal notes or comments about the company.
  - `SendWebhooks` boolean — If true, fires the company_created webhook event to any subscribed endpoints. Defaults to false to preserve existing integration behaviour.

## Response `200`

Returns the created company with assigned Company ID.

- Company — A customer or supplier company record with billing address, contacts, and financial settings.
  - `CompanyID` integer — The unique identifier of the company.
  - `CompanyName` string — The display name of the company.
  - `BillingAddressLine` string — The first line of the company's billing address (street address).
  - `BillingAddressCity` string — The city of the company's billing address.
  - `BillingAddressState` string — The state or province of the company's billing address.
  - `BillingAddressPostCode` string — The postcode or ZIP code of the company's billing address.
  - `BillingCountryCode` string — The ISO 2-letter country code for the company's billing address.
  - `BillingAddress` string — The full formatted billing address string. If set, overrides the individual address fields.
  - `Phone` string — The company's primary phone number.
  - `Fax` string — The company's fax number.
  - `website` string — The company's website URL.
  - `TaxNumber` string — The company's tax registration number.
  - `Comments` string — Internal notes or comments about the company.
  - `CurrencyCode` string — The default currency code used for invoices and transactions with this company.
  - `DefaultTradingTermIDFK` integer — The ID of the default trading terms applied to invoices for this company.
  - `DateCreated` string, date-time — The UTC date and time when the company record was created.
  - `DateUpdated` string, date-time — The UTC date and time when the company record was last updated.
  - `Contacts` CompanyContact[] — The list of external contacts associated with this company.
    - `ContactID` integer — The unique identifier of the contact.
    - `CompanyIDFK` integer — The ID of the company this contact belongs to.
    - `CompanyName` string — The name of the company this contact belongs to.
    - `Firstname` string — The contact's first name.
    - `Lastname` string — The contact's last name.
    - `Email` string — The contact's email address.
    - `Phone` string — The contact's phone number.
    - `Mobile` string — The contact's mobile phone number.
    - `PositionTitle` string — The contact's job title or position.
    - `TimeZone` string — The contact's time zone identifier.
    - `DateCreated` string, date-time — The UTC date and time when the contact record was created.
    - `DateUpdated` string, date-time — The UTC date and time when the contact record was last updated.
    - `Roles` RoleDetails[] — The roles assigned to this contact (RoleCode/RoleName), mirroring the Get UserProfile response.
      - `RoleCode` string — Unique code for the role (e.g. Admin, PM, TimesheetUser).
      - `RoleName` string — Display name of the role.
  - `ViewCompanyURL` string — URL to view this company in the Avaza web application.

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/avaza/apis/avaza-api-documentation.md) · [All operations](https://skmtc.net/avaza/apis/avaza-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/avaza/avaza-api-documentation/versions/1eeadf750514/schema)