Create a Business

Creates a business by passing the required business information.
Business
Create a Business
 last updated: 
July 12, 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. }