---
title: "Create Company"
method: POST
path: "/v1/companies"
---

# Create Company

`POST /v1/companies`

This API endpoint creates a company.

## Request body

- object
  - `name` string, required — The company's name
  - `iconImageUrl` string — Link (URL) to an image to use as the company's icon. Must be a publicly accessible URL.
  - `fallbackColor` string — Hexadecimal value (i.e. "#9BBFFF") of the color used to create an icon if an iconImageUrl is not defined on the company
  - `customFields` string, json — The keys are the key of the custom field property, and the values are an array of custom field option keys (in the case of multiSelect custom fields), or the direct value in the case of all other types of custom fields.

## Response `200`

200

- object
  - `id` string
  - `object` string
  - `createdAt` string
  - `name` string
  - `fallbackColor` string
  - `iconImageUrl` string
  - `isPlaceholder` boolean
  - `customFields` object
    - `phoneNumber` string
    - `tags` string[]
    - `address` object
      - `country` string
      - `region` string
      - `postalCode` string
      - `addressLine1` string
      - `addressLine2` string
      - `city` string
      - `fullAddress` string
    - `email` string
    - `url` string
    - `number` number
    - `text` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/assembly/apis/core-resources.md) · [All operations](https://skmtc.net/assembly/apis/core-resources/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/assembly/core-resources/versions/28a9e7d13a8c/schema)