Create a Business

Creates a business by passing the required business information.
Create a Business
 last updated: 
September 9, 2022

The person used to create the business (in personId header) is automatically added as the first member of the business. You can view this by calling the List all Members API after creating a business.

END POINT

  1. POST /v1/business

REQUEST

  1. {
  2.     "legalName": "Acme LLC",
  3.     "entityType": "limitedLiabilityCompany",
  4.     "dba": "Acme Corp",
  5.     "email": "john@acme.com",
  6.     "idType": "ein",
  7.     "idNumber": "187654321",
  8.     "phone": "+16604491146",
  9.     "formationDate": "2018-02-18",
  10.     "website": "acme.com",
  11.     "about": "clinic for health issues",
  12.     "industry": "healthServices",
  13.     "address": {
  14.         "addressType": "mailing",
  15.         "line1": "456 Main St",
  16.         "line2": "",
  17.         "city": "New York",
  18.         "state": "NY",
  19.         "country": "US",
  20.         "postalCode": "10001"
  21.     }
  22. }

RESPONSE

  1. {
  2.     "id": "bus-0fc3d3cb-f2bf-407b-8377-77acc57f5ea6",
  3.     "legalName": "Acme LLC",
  4.     "entityType": "limitedLiabilityCompany",
  5.     "dba": "Acme Corp",
  6.     "email": "john@acme.com",
  7.     "idNumber": "187654321",
  8.     "idType": "ein",
  9.     "phone": "+16604491146",
  10.     "formationDate": "2018-02-18",
  11.     "website": "acme.com",
  12.     "about": "clinic for health issues",
  13.     "industry": "healthServices",
  14.     "address": {
  15.         "addressType": "mailing",
  16.         "line1": "456 Main St",
  17.         "line2": "",
  18.         "city": "New York",
  19.         "state": "NY",
  20.         "country": "US",
  21.         "postalCode": "10001"
  22.     },
  23.     "kyb": {
  24.         "id": "kyb-f9e32837-19d8-4f66-923b-18648169a8eb",
  25.         "businessId": "bus-0fc3d3cb-f2bf-407b-8377-77acc57f5ea6",
  26.         "status": "notStarted",
  27.         "reviewCode": "",
  28.         "reviewMessage": "",
  29.         "results": {
  30.             "fraud": "notStarted",
  31.             "address": "notStarted",
  32.             "businessName": "notStarted",
  33.             "personName": "notStarted"
  34.         },
  35.         "createdAt": "2021-12-14T23:35:28Z",
  36.         "modifiedAt": "2021-12-14T23:35:28Z"
  37.     },
  38.     "disclosureStatus": "notStarted",
  39.     "createdAt": "2021-12-14T23:35:27Z",
  40.     "modifiedAt": "2021-12-14T23:35:27Z",
  41.     "programId": "prg-b9f17601-4717-460e-bda5-9598f6f6db28",
  42.     "createdPersonId": "per-3ebfa3d2-5d36-411d-984a-9e3a328011c5",
  43.     "metadata": null,
  44.     "status": "active"
  45. }