For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Contact SalesGet Support
HomeGuidesAPI reference
HomeGuidesAPI reference
  • Middesk API
        • POSTCreate a company
LogoLogo
Contact SalesGet Support
Middesk APIEntity ManagementCompanies

Create a company

POST
https://api.middesk.com/v1/partner/companies
POST
/v1/partner/companies
$curl -X POST https://api.middesk.com/v1/partner/companies \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "legal_name": "Acme Corporation",
>  "ein": "123456789",
>  "external_id": "customer_12345",
>  "dba_name": "Acme Co",
>  "contact_email": "[email protected]",
>  "contact_name": "Jane Smith",
>  "contact_phone_number": "(555) 123-4567",
>  "entity_type": "corporation",
>  "formation_state": "DE",
>  "formation_date": "2020-01-15",
>  "addresses": [
>    {
>      "address_line1": "123 Main St",
>      "city": "San Francisco",
>      "state": "CA",
>      "postal_code": "94105",
>      "address_type": "primary"
>    }
>  ]
>}'
1{
2  "object": "agent_company",
3  "id": "comp_abc123",
4  "legal_name": "Acme Corporation",
5  "account_id": "acc_def456",
6  "dba_name": "Acme Co",
7  "external_id": "customer_12345",
8  "parent_account": {
9    "id": "acc_parent789",
10    "name": "Partner Account",
11    "slug": "partner-account"
12  }
13}
Was this page helpful?
Previous

Fetch supported local jurisdictions

Next
Built with

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
legal_namestringRequired
Legal name of the company
einstringOptional
Employer Identification Number
external_idstringOptional
External identifier
dba_namestringOptional
Doing business as name
contact_emailstringOptionalformat: "email"
contact_namestringOptional
contact_phone_numberstringOptional
entity_typestringOptional
formation_statestringOptional
formation_datedateOptional
addresseslist of objectsOptional

Response

company created
objectstring
idstringformat: "uuid"
legal_namestring
Legal name of the company
account_idstringformat: "uuid"
Account ID the company belongs to
dba_namestring or null
Doing business as name
external_idstring or null
External identifier for the company
parent_accountobject

Errors

409
Create Company Request Conflict Error