---
updatedAt: 2026-10-13T21:16:16.000Z
agentTools:
  projectIndex: https://docs.usestable.com/llms.txt
---

# Create a company

Creates a single company.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Stable API",
    "version": "1"
  },
  "paths": {
    "/v1/companies": {
      "post": {
        "summary": "Create a company",
        "description": "Creates a single company.",
        "tags": [
          "Companies"
        ],
        "operationId": "createCompany.post.v1/companies",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCompanyRequestBody"
              }
            }
          },
          "description": "Body required in the request",
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Company"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BadRequestError"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Forbidden"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NotFoundError"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InternalError"
                }
              }
            }
          }
        },
        "security": [
          {
            "x-api-key": []
          }
        ]
      }
    }
  },
  "servers": [
    {
      "url": "https://api.usestable.com",
      "description": "Production"
    },
    {
      "url": "https://api.dev.usestable.com",
      "description": "Development"
    }
  ],
  "components": {
    "securitySchemes": {
      "x-api-key": {
        "type": "apiKey",
        "name": "x-api-key",
        "in": "header"
      }
    },
    "schemas": {
      "CompanyJurisdiction": {
        "properties": {
          "locationCode": {
            "$ref": "#/components/schemas/State"
          },
          "formation": {
            "title": "CompanyJurisdiction.formation",
            "type": "boolean"
          }
        },
        "required": [
          "locationCode",
          "formation"
        ],
        "additionalProperties": false,
        "title": "CompanyJurisdiction",
        "type": "object"
      },
      "Company": {
        "properties": {
          "id": {
            "title": "Company.id",
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/CompanyStatus"
          },
          "legalName": {
            "title": "Company.legalName",
            "type": "string"
          },
          "entityType": {
            "title": "Company.entityType",
            "description": "The entity type, or null if not set.",
            "allOf": [
              {
                "$ref": "#/components/schemas/CompanyEntityType"
              }
            ]
          },
          "ein": {
            "title": "Company.ein",
            "description": "The Employer Identification Number, or null if not set.",
            "type": "string"
          },
          "jurisdictions": {
            "items": {
              "$ref": "#/components/schemas/CompanyJurisdiction"
            },
            "title": "Company.jurisdictions",
            "type": "array"
          },
          "formationDate": {
            "title": "Company.formationDate",
            "description": "The formation date in YYYY-MM-DD format, or null if not set.",
            "type": "string",
            "example": "2024-01-15"
          }
        },
        "required": [
          "id",
          "status",
          "legalName",
          "jurisdictions"
        ],
        "additionalProperties": false,
        "title": "Company",
        "type": "object"
      },
      "State": {
        "enum": [
          "AK",
          "AL",
          "AR",
          "AZ",
          "CA",
          "CO",
          "CT",
          "DC",
          "DE",
          "FL",
          "GA",
          "HI",
          "IA",
          "ID",
          "IL",
          "IN",
          "KS",
          "KY",
          "LA",
          "MA",
          "MD",
          "ME",
          "MI",
          "MN",
          "MO",
          "MS",
          "MT",
          "NC",
          "ND",
          "NE",
          "NH",
          "NJ",
          "NM",
          "NV",
          "NY",
          "OH",
          "OK",
          "OR",
          "PA",
          "PR",
          "RI",
          "SC",
          "SD",
          "TN",
          "TX",
          "UT",
          "VA",
          "VT",
          "WA",
          "WI",
          "WV",
          "WY"
        ],
        "title": "State",
        "type": "string"
      },
      "CompanyStatus": {
        "enum": [
          "active",
          "inactive"
        ],
        "title": "CompanyStatus",
        "type": "string"
      },
      "CompanyEntityType": {
        "enum": [
          "association",
          "attorney-for-bar",
          "benefit-corporation",
          "benefit-llc",
          "benefit-professional-corporation",
          "close-corporation",
          "close-limited-liability-company",
          "close-professional-corporation",
          "cooperative",
          "corporation-sole",
          "corporation",
          "doing-business-as-name",
          "exempt-nonstock-corporation",
          "general-partnership",
          "individual",
          "limited-liability-company",
          "limited-liability-limited-partnership",
          "limited-liability-partnership",
          "limited-partnership",
          "low-profit-limited-liability-company",
          "massachusetts-trust",
          "mutual-benefit-enterprise",
          "mutual-benefit-nonprofit-corporation",
          "nonprofit-corporation",
          "nonprofit-limited-liability-company",
          "personal-attorney",
          "professional-corporation",
          "professional-limited-liability-company",
          "professional-limited-liability-limited-partnership",
          "professional-limited-liability-partnership",
          "professional-limited-partnership",
          "public-benefit-nonprofit-corporation",
          "religious-nonprofit-corporation",
          "series-limited-liability-company",
          "series-professional-limited-liability-company",
          "sole-proprietorship",
          "sustainable-business-corporation",
          "trust"
        ],
        "title": "CompanyEntityType",
        "type": "string"
      },
      "CreateCompanyRequestBody": {
        "properties": {
          "legalName": {
            "title": "CreateCompanyRequestBody.legalName",
            "description": "Legal name of the company.",
            "type": "string",
            "example": "Ada's Apples LLC"
          },
          "entityType": {
            "title": "CreateCompanyRequestBody.entityType",
            "description": "Entity type of the company.",
            "allOf": [
              {
                "$ref": "#/components/schemas/CompanyEntityType"
              }
            ]
          },
          "jurisdictions": {
            "items": {
              "$ref": "#/components/schemas/State"
            },
            "title": "CreateCompanyRequestBody.jurisdictions",
            "description": "List of states in which the company operates.",
            "type": "array"
          },
          "formationJurisdiction": {
            "title": "CreateCompanyRequestBody.formationJurisdiction",
            "description": "State in which the company was formed. Must be included in `jurisdictions`.",
            "allOf": [
              {
                "$ref": "#/components/schemas/State"
              }
            ]
          },
          "formationDate": {
            "title": "CreateCompanyRequestBody.formationDate",
            "description": "Date the company was formed, in YYYY-MM-DD format.",
            "type": "string",
            "example": "2024-01-15"
          },
          "ein": {
            "title": "CreateCompanyRequestBody.ein",
            "description": "Employer Identification Number in the format xx-xxxxxxx.",
            "type": "string",
            "example": "12-3456789"
          }
        },
        "required": [
          "legalName",
          "entityType",
          "jurisdictions",
          "formationJurisdiction"
        ],
        "additionalProperties": false,
        "title": "CreateCompanyRequestBody",
        "type": "object"
      },
      "BadRequestError": {
        "properties": {
          "message": {
            "title": "BadRequestError.message",
            "enum": [
              "Bad Request"
            ],
            "type": "string"
          }
        },
        "required": [
          "message"
        ],
        "additionalProperties": false,
        "title": "BadRequestError",
        "type": "object"
      },
      "NotFoundError": {
        "properties": {
          "message": {
            "title": "NotFoundError.message",
            "enum": [
              "Not Found"
            ],
            "type": "string"
          }
        },
        "required": [
          "message"
        ],
        "additionalProperties": false,
        "title": "NotFoundError",
        "type": "object"
      },
      "Forbidden": {
        "properties": {
          "message": {
            "title": "Forbidden.message",
            "enum": [
              "Forbidden"
            ],
            "type": "string"
          }
        },
        "required": [
          "message"
        ],
        "additionalProperties": false,
        "title": "Forbidden",
        "type": "object"
      },
      "InternalError": {
        "properties": {
          "message": {
            "title": "InternalError.message",
            "enum": [
              "Internal Error"
            ],
            "type": "string"
          }
        },
        "required": [
          "message"
        ],
        "additionalProperties": false,
        "title": "InternalError",
        "type": "object"
      }
    }
  }
}
```