> ## Documentation Index
> Fetch the complete documentation index at: https://developer.lulacommerce.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Company

> This endpoint creates a new company in the system. Companies serve as the parent entity for stores and manage business-level information including contact details, addresses, and operational status.

This endpoint allows you to create a new company with all necessary business information. The company will be assigned a unique ID and can then be used to create and manage stores under its umbrella.

<Accordion title="Request Body Fields">
  <ResponseField name="name" type="string" required>
    Company name. Example: "Salman's Company"
  </ResponseField>

  <ResponseField name="email" type="string" required>
    Company contact email address. Example: "[test@company.com](mailto:test@company.com)"
  </ResponseField>

  <ResponseField name="address" type="object" required>
    Company address information

    <Expandable title="address">
      <ResponseField name="line_1" type="string" required>
        Primary address line. Example: "123 Main Street"
      </ResponseField>

      <ResponseField name="city" type="string" required>
        City name. Example: "Philadelphia"
      </ResponseField>

      <ResponseField name="state" type="string" required>
        State or province. Example: "PA"
      </ResponseField>

      <ResponseField name="zip" type="string" required>
        ZIP or postal code. Example: "19104"
      </ResponseField>
    </Expandable>
  </ResponseField>

  <ResponseField name="phone_number" type="string" required>
    Company contact phone number. Example: "090078601"
  </ResponseField>

  <ResponseField name="website" type="string">
    Company website URL. Example: "[https://www.lulaconvenience.com/](https://www.lulaconvenience.com/)"

    <Note>Note the correct spelling is "website" not "webiste"</Note>
  </ResponseField>

  <ResponseField name="logo" type="string">
    Company logo URL or base64 encoded image
  </ResponseField>

  <ResponseField name="banner" type="string">
    Company banner image URL or base64 encoded image
  </ResponseField>

  <ResponseField name="profile_image" type="string">
    Company profile image URL or base64 encoded image
  </ResponseField>

  <ResponseField name="receipt_header" type="string">
    Custom header text for receipts
  </ResponseField>

  <ResponseField name="ein" type="string" required>
    Employer Identification Number. Example: "0000"
  </ResponseField>

  <ResponseField name="status" type="string" required>
    Company operational status. Example: "On Boarding"

    <Accordion title="Valid Status Values">
      * On Boarding
      * Live
      * Off Boarding
      * Churned
      * Suspended
    </Accordion>
  </ResponseField>

  <ResponseField name="company_type" type="string" required>
    Type of company classification. Example: "Mid-Market"

    <Accordion title="Valid Company Types">
      * Enterprise
      * Mid-Market
      * Small Business
      * Startup
    </Accordion>
  </ResponseField>

  <ResponseField name="active" type="number" required>
    Company active status. Use 1 for active, 0 for inactive

    <Warning>Setting to 0 will deactivate the company and all associated stores</Warning>
  </ResponseField>

  <ResponseField name="hubspot_id" type="number">
    Associated HubSpot contact ID for CRM integration. Example: 12121212121212
  </ResponseField>
</Accordion>

### Request Example

```json theme={null}
{
    "name": "Salman's Company",
    "email": "test@company.com",
    "address": {
        "line_1": "123 Main Street",
        "city": "Philadelphia",
        "state": "PA",
        "zip": "19104"
    },
    "phone_number": "090078601",
    "website": "https://www.lulaconvenience.com/",
    "logo": "",
    "banner": "",
    "profile_image": "",
    "receipt_header": "",
    "ein": "0000",
    "status": "On Boarding",
    "company_type": "Mid-Market",
    "active": 1,
    "hubspot_id": 12121212121212
}
```

### Response

<ResponseField name="id" type="string">
  Unique company identifier generated by the system
</ResponseField>

<ResponseField name="address_id" type="string">
  Unique identifier for the company's address record
</ResponseField>

<ResponseField name="name" type="string">
  Company name as provided in the request
</ResponseField>

<ResponseField name="email" type="string">
  Company contact email address
</ResponseField>

<ResponseField name="phone_number" type="string">
  Company contact phone number
</ResponseField>

<ResponseField name="logo" type="string">
  Company logo URL or encoded image
</ResponseField>

<ResponseField name="banner" type="string">
  Company banner image URL or encoded image
</ResponseField>

<ResponseField name="profile_image" type="string">
  Company profile image URL or encoded image
</ResponseField>

<ResponseField name="receipt_header" type="string">
  Custom receipt header text
</ResponseField>

<ResponseField name="ein" type="string">
  Employer Identification Number
</ResponseField>

<ResponseField name="status" type="string">
  Current company operational status
</ResponseField>

<ResponseField name="company_type" type="string">
  Company classification type
</ResponseField>

<ResponseField name="active" type="number">
  Company active status (1 = active, 0 = inactive)
</ResponseField>

<ResponseField name="hubspot_id" type="string">
  Associated HubSpot contact ID
</ResponseField>

<ResponseField name="updated_at" type="string">
  Timestamp of last update (ISO 8601 format)
</ResponseField>

<ResponseField name="created_at" type="string">
  Timestamp of creation (ISO 8601 format)
</ResponseField>

<ResponseField name="website" type="string">
  Company website URL
</ResponseField>

<ResponseField name="created_by" type="string">
  ID of user who created the company record
</ResponseField>

<ResponseField name="updated_by" type="string">
  ID of user who last updated the company record
</ResponseField>

<ResponseField name="deleted_at" type="string">
  Timestamp of deletion (null if not deleted)
</ResponseField>

### Response Example

```json theme={null}
{
    "id": "1000003",
    "address_id": "480c9c0c-50b8-4911-89db-e63d68c6f58a",
    "name": "Salman's Company",
    "email": "test@company.com",
    "phone_number": "090078601",
    "logo": "",
    "banner": "",
    "profile_image": "",
    "receipt_header": "",
    "ein": "0000",
    "status": "On Boarding",
    "company_type": "Mid-Market",
    "active": 1,
    "hubspot_id": "12121212121212",
    "updated_at": "2023-06-19T15:22:31.591Z",
    "created_at": "2023-06-19T15:22:31.591Z",
    "website": null,
    "created_by": null,
    "updated_by": null,
    "deleted_at": null
}
```