---
title: "Create a new company"
method: POST
path: "/v1/companies"
tags: ["Companies/Entities"]
---

# Create a new company

`POST /v1/companies`

Create a new company to use as an entity that you manage

## Request body

- object
  - `name` string, required — The name of the company
  - `type` 'INDIVIDUAL' | 'BUSINESS' — Type of company to create
  - `sandbox` boolean — Set company as a sandbox which will prevent it from withdrawing funds to a bank account but can be used for testing
  - `relationship` 'PAYEE' | 'CLIENT' | 'FULL' — The relationship between the managing metal company and this company. Payee is the default and is a company that can receive payments. Client means they can be invoiced and Full allows for both.
  - `billing_email` string — For companies that will be issued invoices (payees) specify the email address that should be attached to those invoices
  - `generate_onboard_link` boolean — Only supported for client companies right now, this will generate a link for them to fill in details of their business themselves

## Response `200`

The new Company object

- object
  - `data` Company
    - `id` string
    - `name` string
    - `type` 'INDIVIDUAL' | 'BUSINESS' | 'MANAGING_BUSINESS' | 'LP_INDIVIDUAL' | 'LP_BUSINESS'
    - `status` 'ACTIVE' | 'RESTRICTED' | 'DENIED'
    - `kyb_status` 'NOT_REQUIRED' | 'NOT_STARTED' | 'PENDING' | 'SUCCESS' | 'FAIL' | 'ERROR' | 'PROCESSING'
    - `legal_business_name` string, nullable
    - `business_tax_id` string, nullable
    - `website` string, nullable
    - `phone` string, nullable
    - `address_id` integer, nullable
    - `sandbox` boolean — Sandbox mode
    - `formation_date` string, nullable
    - `kyb_mode` 'FULL' | 'NONE' | 'LITE'
    - `duns` string, nullable
    - `stock_symbol` string, nullable
    - `country` string, nullable — Country where the company is based
    - `enabled` boolean
    - `credit_verification_status` 'FAIL' | 'PENDING' | 'SUCCESS'
    - `credit_limit` integer, nullable
    - `credit_rating` string, nullable
    - `invoice_reply_to_email` string, nullable
    - `po_reply_to_email` string, nullable
    - `birthday` string, date-time, nullable — Birthday of user. Only applies to individual type
    - `logo_url` string — URL of company logo
    - `invite_image_url` string
    - `header_image_url` string
    - `square_image_url` string
    - `terms_url` string
    - `privacy_url` string
    - `credit_used` integer

---

[API](https://skmtc.net/newmoneycompany/apis/new-money-company-api.md) · [All operations](https://skmtc.net/newmoneycompany/apis/new-money-company-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/newmoneycompany/new-money-company-api/revisions/669cac9303c2/schema)