Create a company

curl --request POST \
  --url https://api.test.doola.com/v1/partner/companies \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "doolaCustomerId": "3GS8Guk4H6BiP8tgfNVIQDFvKQ9",
  "entityType": "LLC",
  "state": "WY",
  "nameOptions": [
    {
      "name": "Acme Labs",
      "entityTypeEnding": "LLC"
    }
  ],
  "industry": "Custom Computer Programming Services",
  "description": "Custom software development for small businesses.",
  "responsibleParty": {
    "legalFirstName": "Ada",
    "legalLastName": "Lovelace",
    "email": "ada@example.com",
    "ssn": "123-45-6789",
    "address": {
      "line1": "251 W 30th St",
      "line2": "Ste 12E",
      "city": "New York",
      "state": "NY",
      "postalCode": "10001",
      "country": "USA",
      "phone": "+12125550100"
    }
  },
  "addresses": [
    {
      "provider": "customer",
      "type": "mailing",
      "address": {
        "line1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA"
      }
    },
    {
      "provider": "registeredAgent",
      "type": "business"
    }
  ],
  "members": [
    {
      "isNaturalPerson": true,
      "legalFirstName": "Ada",
      "legalLastName": "Lovelace",
      "ownershipPercent": 100,
      "address": {
        "line1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA",
        "phone": "+12125550100"
      }
    }
  ]
}
'

{
  "doolaCompanyId": "3GS9gsGmVOomgWbdvdkYe5S1We6",
  "doolaCustomerId": "3GS8Guk4H6BiP8tgfNVIQDFvKQ9",
  "entityType": "LLC",
  "state": "WY",
  "nameOptions": [
    {
      "id": "3GS9gy7p6XeGwLNzpBfrywhHV8I",
      "name": "Acme Labs",
      "entityTypeEnding": "LLC",
      "position": 0
    }
  ],
  "naicsCode": "541511",
  "industry": "Custom Computer Programming Services",
  "description": "Custom software development for small businesses.",
  "responsibleParty": {
    "id": "3GS9gz0xoo4muvao4StueQho0bz",
    "legalFirstName": "Ada",
    "legalLastName": "Lovelace",
    "ssn": "****-**-6789",
    "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": "customer",
      "type": "mailing",
      "address": {
        "line1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA"
      }
    },
    {
      "provider": "registeredAgent",
      "type": "business",
      "address": {
        "line1": "30 N Gould St STE R",
        "city": "Sheridan",
        "state": "WYOMING",
        "postalCode": "82801",
        "country": "USA"
      }
    }
  ],
  "members": [
    {
      "id": "3GS9gudNgT6hrvovLep2tSO8PKR",
      "legalFirstName": "Ada",
      "legalLastName": "Lovelace",
      "isNaturalPerson": true,
      "address": {
        "line1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA",
        "phone": "+12125550100"
      },
      "ownershipPercent": 100
    }
  ],
  "adminNotes": [],
  "formationSubmissionStatus": "PENDING",
  "services": [
    {
      "name": "Formation",
      "variant": "NONE",
      "status": "InProgress",
      "subStatus": "WaitingForRaToSucceed"
    },
    {
      "name": "EinCreation",
      "variant": "NONE",
      "status": "NotStarted",
      "subStatus": "WaitingForFilingServiceToComplete"
    },
    {
      "name": "RegisteredAgent",
      "variant": "NONE",
      "status": "NotStarted",
      "subStatus": "WaitingForFormation"
    },
    {
      "name": "AiCofounder",
      "variant": "NONE",
      "status": "Active"
    }
  ],
  "signatureRequirements": []
}

POST

partner

companies

curl --request POST \
  --url https://api.test.doola.com/v1/partner/companies \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "doolaCustomerId": "3GS8Guk4H6BiP8tgfNVIQDFvKQ9",
  "entityType": "LLC",
  "state": "WY",
  "nameOptions": [
    {
      "name": "Acme Labs",
      "entityTypeEnding": "LLC"
    }
  ],
  "industry": "Custom Computer Programming Services",
  "description": "Custom software development for small businesses.",
  "responsibleParty": {
    "legalFirstName": "Ada",
    "legalLastName": "Lovelace",
    "email": "ada@example.com",
    "ssn": "123-45-6789",
    "address": {
      "line1": "251 W 30th St",
      "line2": "Ste 12E",
      "city": "New York",
      "state": "NY",
      "postalCode": "10001",
      "country": "USA",
      "phone": "+12125550100"
    }
  },
  "addresses": [
    {
      "provider": "customer",
      "type": "mailing",
      "address": {
        "line1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA"
      }
    },
    {
      "provider": "registeredAgent",
      "type": "business"
    }
  ],
  "members": [
    {
      "isNaturalPerson": true,
      "legalFirstName": "Ada",
      "legalLastName": "Lovelace",
      "ownershipPercent": 100,
      "address": {
        "line1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA",
        "phone": "+12125550100"
      }
    }
  ]
}
'

{
  "doolaCompanyId": "3GS9gsGmVOomgWbdvdkYe5S1We6",
  "doolaCustomerId": "3GS8Guk4H6BiP8tgfNVIQDFvKQ9",
  "entityType": "LLC",
  "state": "WY",
  "nameOptions": [
    {
      "id": "3GS9gy7p6XeGwLNzpBfrywhHV8I",
      "name": "Acme Labs",
      "entityTypeEnding": "LLC",
      "position": 0
    }
  ],
  "naicsCode": "541511",
  "industry": "Custom Computer Programming Services",
  "description": "Custom software development for small businesses.",
  "responsibleParty": {
    "id": "3GS9gz0xoo4muvao4StueQho0bz",
    "legalFirstName": "Ada",
    "legalLastName": "Lovelace",
    "ssn": "****-**-6789",
    "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": "customer",
      "type": "mailing",
      "address": {
        "line1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA"
      }
    },
    {
      "provider": "registeredAgent",
      "type": "business",
      "address": {
        "line1": "30 N Gould St STE R",
        "city": "Sheridan",
        "state": "WYOMING",
        "postalCode": "82801",
        "country": "USA"
      }
    }
  ],
  "members": [
    {
      "id": "3GS9gudNgT6hrvovLep2tSO8PKR",
      "legalFirstName": "Ada",
      "legalLastName": "Lovelace",
      "isNaturalPerson": true,
      "address": {
        "line1": "251 W 30th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA",
        "phone": "+12125550100"
      },
      "ownershipPercent": 100
    }
  ],
  "adminNotes": [],
  "formationSubmissionStatus": "PENDING",
  "services": [
    {
      "name": "Formation",
      "variant": "NONE",
      "status": "InProgress",
      "subStatus": "WaitingForRaToSucceed"
    },
    {
      "name": "EinCreation",
      "variant": "NONE",
      "status": "NotStarted",
      "subStatus": "WaitingForFilingServiceToComplete"
    },
    {
      "name": "RegisteredAgent",
      "variant": "NONE",
      "status": "NotStarted",
      "subStatus": "WaitingForFormation"
    },
    {
      "name": "AiCofounder",
      "variant": "NONE",
      "status": "Active"
    }
  ],
  "signatureRequirements": []
}

Authorizations

Authorization

string

header

required

Partner API key. Send the raw key as the Authorization header value — e.g. dk_test_… in sandbox or dk_live_… in production. Generate and rotate keys in the doola Partner Portal.

Headers

Idempotency-Key

string

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.

Body

application/json

Request body to create (form) a company for one of your customers.

doolaCustomerId

string

required

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

Minimum string length: 1

state

string

required

US state of formation (two-letter abbreviation).

Example:

"DE"

nameOptions

object[]

required

Candidate company names, in order of preference. One to three entries.

Show child attributes

description

string

required

Short description of what the business does.

Minimum string length: 1

Example:

"Custom software development for small businesses."

responsibleParty

object

required

The person legally responsible for the company.

Show child attributes

addresses

object[]

required

Company addresses. Exactly two entries are required: one mailing and one business. Each entry is either customer-provided or handed to doola's Registered Agent (see the provider field).

Show child attributes

entityType

enum<string>

default:LLC

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

Available options:

LLC,

CCorp

Example:

"LLC"

industry

string

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.

Example:

"Custom Computer Programming Services"

naicsCode

string

deprecated

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.

Example:

"541511"

members

object[]

Company members/owners. Required for an LLC (ownership percentages must total 100); omit for a CCorp.

Show child attributes

executiveMembers

object[]

C-Corp officers and directors. Required for a CCorp; omit for an LLC. Include at least one President, Secretary, Treasurer, and Director; the President, Secretary, and Treasurer may each appear only once.

Show child attributes

ccorpValuation

object

C-Corp share structure. Required for a CCorp; omit for an LLC.

Show child attributes

requestedServices

object[]

Optional per-service variant overrides. Today only the EIN service is configurable: include { "service": "EinCreation", "variant": "Expedite" } to request the expedited EIN (requires a non-US applicant). Omit for standard processing.

Show child attributes

Response

201 - application/json

Created

List companies Get a company

Get started

Core concepts

Reference

API reference

Help

Updates

Authorizations

Headers

Body

Response