DOdoola
Companies

Create a company

Changed on

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

Request

  • Base URL
    https://api.test.doola.com
  • URL
    https://api.test.doola.com/v1/partner/companies
  • Auth
    API key in header Authorization

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 required

Unique NAICS industry label (the industry value from GET /v1/partner/references/naics-codes), sent verbatim.

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",
  "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

Changes

  • f607744a8927Revision changes
    • breaking

      the request property became required

    • breaking

      the request property's minLength was increased from 0 to 1

    • breaking

      the request property's minLength was increased from 0 to 1

    • breaking

      the request property's minLength was increased from 0 to 1

    • warning

      the request property's maxLength was set to 50

    • warning

      removed the request property