---
title: "Add companies"
method: POST
path: "/api/v4/companies"
---

# Add companies

`POST /api/v4/companies`

This method allows adding one or more companies into the account

## Request body

- object
  - `RAW_BODY` object[]
    - `id` integer — Company ID
    - `name` string — Company name
    - `responsible_user_id` integer — Company responsible user ID
    - `created_by` integer — The ID of the user who created the company
    - `updated_by` integer — The ID of the user who updated the company last
    - `created_at` integer — Company creation date in the format of Unix Timestamp
    - `updated_at` integer — Company update date in the format of Unix Timestamp
    - `custom_fields_values` string, json — An array of the current company custom fields’ values.
    - `_embedded` object
      - `tags` object[]
        - `id` integer — Tag ID
        - `name` string — Tag name
    - `request_id` string — The field will be returned unchanged in the response and will not be saved.
    - `tags_to_add` object[] — Array of tags to add. Either ID or tag name must be passed.
      - `id` integer — Tag ID
      - `name` string — Tag name

## Response `200`

200

- object
  - `_links` object
    - `self` object
      - `href` string
  - `_embedded` object
    - `companies` object[]
      - `id` integer
      - `is_deleted` boolean
      - `request_id` string
      - `_links` object
        - `self` object
          - `href` string

## Other responses

- `400` — 400
- `401` — 401

---

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