---
title: "Create Company"
method: POST
path: "/company/"
tags: ["Onboarding"]
---

# Create Company

`POST /company/`

Create a company.

## Headers

- `x-company-id` integer — ID of a child company for authentication. If not provided, the parent company will be authenticated.

## Request body

- CreateCompanyRequest
  - `business_name` string, required — Business legal name
  - `friendly_name` string, required — Business friendly name (trading name)
  - `country_of_registration` string, required — Country of registration in ISO 3166-1 alpha-2 format, e.g. AR, BR, etc.
  - `registration_number` string, required — Registration number, e.g. CNPJ, VAT number, etc.
  - `entity_type` string, required — Entity type, e.g. LLC, INC, etc.
  - `idempotency_key` string — A unique key that ensures a request is processed only once. If the same key is sent with multiple requests, the server returns the original response instead of performing the action again.
  - `acc_default_webhook_url` string — Account default webhook URL. All the accounts created for this company will have this webhook url by default

## Response `200`

Successful Response

- CompanyResponse
  - `status` 'success'
  - `data` ShowableCompany, required
    - `id` string, required — Company ID
    - `idempotency_key` string — A unique key that ensures a request is processed only once. If the same key is sent with multiple requests, the server returns the original response instead of performing the action again.
    - `created_at` string, date-time — Creation date of the company
    - `business_name` string — Business legal name
    - `friendly_name` string — Business friendly name (trading name)
    - `country_of_registration` string — Country of registration in ISO 3166-1 alpha-2 format, e.g. AR, BR, etc.
    - `registration_number` string — Registration number, e.g. CNPJ, VAT number, etc.
    - `entity_type` string — Entity type, e.g. LLC, INC, etc.
    - `acc_default_webhook_url` string — Account default webhook URL. All the accounts created for this company will have this webhook url by default
    - `parent_company_id` string — Parent company ID

## Other responses

- `400` — Bad Request
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/infiniaweb/apis/payins.md) · [All operations](https://skmtc.net/infiniaweb/apis/payins/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/infiniaweb/payins/revisions/3f453785c478/schema)