---
title: "Company Add"
method: POST
path: "/companies/"
tags: ["COMPANY"]
---

# Company Add

`POST /companies/`

## Request

- Base URL: `https://api.myaltimate.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.myaltimate.com/companies/`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Add a company. This operation is allowed only in the root domain.

## Request body

- CompanyCreateIn
  - `name` string, nullable
  - `country` string, nullable
  - `provider` 'snowflake' | 'databricks'

## Response `200`

Successful Response

- CompanyIndexResponse
  - `name` string, nullable
  - `country` string, nullable
  - `uuid` string, uuid, required
  - `provider` string, nullable
  - `created_at` string, date-time, nullable
  - `existence_time` string, nullable

## Other responses

- `400`: Bad request.
- `403`: This operation is forbidden in the tenant domain.
- `422`: Validation Error

## Changes

- **2026-10-14** `1b2d675195d7`: 2 info
  - added the new optional request property `provider`
  - added the optional property `provider` to the response with the `200` status

[Operation history](https://skmtc.dev/myaltimate/apis/myaltimate-api/changes/companies/post.md)

---

[API](https://skmtc.dev/myaltimate/apis/myaltimate-api.md) - [All operations](https://skmtc.dev/myaltimate/apis/myaltimate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/myaltimate/apis/myaltimate-api/revisions/727657ce54e9?raw)