Sign in

v1

latestOpenAPI 3.0.12026-07-22154142.9 KB
Companies

Create a company

Starts a company formation for one of your customers. Set entityType to LLC (the default) or CCorp: an LLC takes members, while a CCorp takes executiveMembers and ccorpValuation. Idempotent on the Idempotency-Key header: a successful create is replayed for the same key, so retries never start a duplicate formation. If a create fails before it commits, the key is released — fix the request and retry with the same key.

post/v1/partner/companies

Headers

Idempotency-Keystring required

Unique key that makes the create safe to retry. Reuse the same value to retry; if the create fails before committing, the key is released, so retry with the same value.

Request body

doolaCustomerIdstring required

doola customer ID (KSUID) that will own the company.

entityType'LLC' | 'CCorp'

Entity type to form. Defaults to LLC when omitted. An LLC takes members; a CCorp takes executiveMembers and ccorpValuation.

statestring required

US state of formation (two-letter abbreviation).

industrystring

Unique NAICS industry label (the industry value from GET /v1/partner/references/naics-codes). Preferred over naicsCode: Provide either industry or naicsCode; when both are sent, industry wins.

naicsCodestring

NAICS industry code. DEPRECATED — use industry instead. When industry is also provided it takes precedence and this value is ignored; otherwise it must exist in the reference list. Supported through the 90-day deprecation window for backwards compatibility.

descriptionstring required

Short description of what the business does.

Example request

{
  "entityType": "LLC",
  "state": "DE",
  "nameOptions": [
    {
      "name": "Acme Labs",
      "entityTypeEnding": "LLC",
      "position": 1
    }
  ],
  "industry": "Custom Computer Programming Services",
  "naicsCode": "541511",
  "description": "Custom software development for small businesses.",
  "responsibleParty": {
    "legalFirstName": "Ada",
    "legalLastName": "Lovelace",
    "email": "ada@example.com",
    "address": {
      "line1": "251 W 30th St",
      "line2": "Ste 12E",
      "city": "New York",
      "state": "NY",
      "postalCode": "10001",
      "country": "USA",
      "phone": "+12125550100"
    }
  },
  "addresses": [
    {
      "provider": "registeredAgent",
      "type": "business",
      "address": {
        "line1": "251 W 30th St",
        "line2": "Ste 12E",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA",
        "phone": "+12125550100"
      }
    }
  ],
  "members": [
    {
      "legalFirstName": "Ada",
      "legalLastName": "Lovelace",
      "contactFullName": "Acme Holdings LLC",
      "isNaturalPerson": true,
      "address": {
        "line1": "251 W 30th St",
        "line2": "Ste 12E",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA",
        "phone": "+12125550100"
      },
      "ownershipPercent": 100
    }
  ],
  "executiveMembers": [
    {
      "type": "President",
      "legalFirstName": "Ada",
      "legalLastName": "Lovelace",
      "address": {
        "line1": "251 W 30th St",
        "line2": "Ste 12E",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA",
        "phone": "+12125550100"
      }
    }
  ],
  "ccorpValuation": {
    "noOfShares": 10000000,
    "shareValue": 0.0001
  },
  "requestedServices": [
    {
      "service": "EinCreation",
      "variant": "Expedite"
    }
  ]
}

Response

Created

errorobject

Example response

{
  "payload": {
    "entityType": "LLC",
    "state": "DE",
    "nameOptions": [
      {
        "name": "Acme Labs",
        "entityTypeEnding": "LLC",
        "position": 1
      }
    ],
    "naicsCode": "541511",
    "industry": "Custom Computer Programming Services",
    "responsibleParty": {
      "legalFirstName": "Ada",
      "legalLastName": "Lovelace",
      "email": "ada@example.com",
      "address": {
        "line1": "251 W 30th St",
        "line2": "Ste 12E",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA",
        "phone": "+12125550100"
      }
    },
    "addresses": [
      {
        "provider": "registeredAgent",
        "type": "business",
        "address": {
          "line1": "251 W 30th St",
          "line2": "Ste 12E",
          "city": "New York",
          "state": "NY",
          "postalCode": "10001",
          "country": "USA",
          "phone": "+12125550100"
        }
      }
    ],
    "members": [
      {
        "legalFirstName": "Ada",
        "legalLastName": "Lovelace",
        "contactFullName": "Acme Holdings LLC",
        "isNaturalPerson": true,
        "address": {
          "line1": "251 W 30th St",
          "line2": "Ste 12E",
          "city": "New York",
          "state": "NY",
          "postalCode": "10001",
          "country": "USA",
          "phone": "+12125550100"
        },
        "ownershipPercent": 100
      }
    ],
    "ein": "99-1234567",
    "services": [
      {
        "name": "Registered Agent"
      }
    ],
    "executiveMembers": [
      {
        "type": "President",
        "legalFirstName": "Ada",
        "legalLastName": "Lovelace",
        "address": {
          "line1": "251 W 30th St",
          "line2": "Ste 12E",
          "city": "New York",
          "state": "NY",
          "postalCode": "10001",
          "country": "USA",
          "phone": "+12125550100"
        }
      }
    ],
    "ccorpValuation": {
      "noOfShares": 10000000,
      "shareValue": 0.0001
    },
    "signatureRequirements": [
      {
        "documentType": "SS4",
        "status": "PENDING"
      }
    ]
  }
}