Create a company

var client = new RestClient("https://api.middesk.com/v1/partner/companies");
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Basic <username>:<password>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"legal_name\": \"Acme Corporation\",\n  \"ein\": \"123456789\",\n  \"external_id\": \"customer_12345\",\n  \"dba_name\": \"Acme Co\",\n  \"contact_email\": \"contact@acme.com\",\n  \"contact_name\": \"Jane Smith\",\n  \"contact_phone_number\": \"(555) 123-4567\",\n  \"entity_type\": \"corporation\",\n  \"formation_state\": \"DE\",\n  \"formation_date\": \"2020-01-15\",\n  \"addresses\": [\n    {\n      \"address_line1\": \"123 Main St\",\n      \"city\": \"San Francisco\",\n      \"state\": \"CA\",\n      \"postal_code\": \"94105\",\n      \"address_type\": \"primary\"\n    }\n  ]\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

{
  "object": "agent_company",
  "id": "comp_abc123",
  "legal_name": "Acme Corporation",
  "account_id": "acc_def456",
  "dba_name": "Acme Co",
  "external_id": "customer_12345",
  "parent_account": {
    "id": "acc_parent789",
    "name": "Partner Account",
    "slug": "partner-account"
  }
}

Authentication

AuthorizationBasic

Basic authentication of the form Basic <username:password>.

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 or null

Authentication

Request

Response

Errors