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": []
}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.
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
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
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
Request body to create (form) a company for one of your customers.
doola customer ID (KSUID) that will own the company.
1US state of formation (two-letter abbreviation).
"DE"
Candidate company names, in order of preference. One to three entries.
Show child attributes
Show child attributes
Short description of what the business does.
1 - 50"Custom software development for small businesses."
The person legally responsible for the company.
Show child attributes
Show child attributes
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
Show child attributes
Entity type to form. Defaults to LLC when omitted. An LLC takes members; a CCorp takes executiveMembers and ccorpValuation.
LLC, CCorp "LLC"
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.
"Custom Computer Programming Services"
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.
"541511"
Company members/owners. Required for an LLC (ownership percentages must total 100); omit for a CCorp.
Show child attributes
Show child attributes
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
Show child attributes
C-Corp share structure. Required for a CCorp; omit for an LLC.
Show child attributes
Show child attributes
Optional per-service variant overrides. Today only the EIN service is configurable: include { "service": "EinCreation", "variant": "Expedite" } to request expedited EIN. Available when no member, executive member, or responsible party supplies a valid SSN; ITIN-only companies are eligible. SSNs are checked for format, not issuance. Omit for standard processing.
Show child attributes
Show child attributes
Response
Created