Create Company
Companies
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.
POST
Create Company
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.
Request Body Fields
Request Body Fields
string
required
Company name. Example: “Salman’s Company”
string
required
Company contact email address. Example: “[email protected]”
object
required
Company address information
string
required
Company contact phone number. Example: “090078601”
string
Company website URL. Example: “https://www.lulaconvenience.com/“
Note the correct spelling is “website” not “webiste”
string
Company logo URL or base64 encoded image
string
Company banner image URL or base64 encoded image
string
Company profile image URL or base64 encoded image
string
Custom header text for receipts
string
required
Employer Identification Number. Example: “0000”
string
required
Company operational status. Example: “On Boarding”
Valid Status Values
Valid Status Values
- On Boarding
- Live
- Off Boarding
- Churned
- Suspended
string
required
Type of company classification. Example: “Mid-Market”
Valid Company Types
Valid Company Types
- Enterprise
- Mid-Market
- Small Business
- Startup
number
required
Company active status. Use 1 for active, 0 for inactive
number
Associated HubSpot contact ID for CRM integration. Example: 12121212121212
Request Example
Response
string
Unique company identifier generated by the system
string
Unique identifier for the company’s address record
string
Company name as provided in the request
string
Company contact email address
string
Company contact phone number
string
Company logo URL or encoded image
string
Company banner image URL or encoded image
string
Company profile image URL or encoded image
string
Custom receipt header text
string
Employer Identification Number
string
Current company operational status
string
Company classification type
number
Company active status (1 = active, 0 = inactive)
string
Associated HubSpot contact ID
string
Timestamp of last update (ISO 8601 format)
string
Timestamp of creation (ISO 8601 format)
string
Company website URL
string
ID of user who created the company record
string
ID of user who last updated the company record
string
Timestamp of deletion (null if not deleted)

