Skip to main content
POST
/
stores
/
store
Create Store
curl --request POST \
  --url https://api-staging.luladelivery.store/stores/store/
{
  "id": "<string>",
  "store_setup_completed": true,
  "is_disabled": true,
  "is_rbac_store": true,
  "name": "<string>",
  "email": "<string>",
  "phone_number": "<string>",
  "company_id": "<string>",
  "point_of_contact": "<string>",
  "bill_vendor_id": "<string>",
  "addresses": [
    {}
  ],
  "store_partners": [
    {}
  ],
  "vendor": "<string>"
}

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.

This endpoint creates a new store with all necessary business information including addresses, company association, and delivery service partner integrations. The store will be automatically configured with UberEats, DoorDash, and GrubHub partnerships.
​
name
string
required
Store name as it will appear to customers. Example: “SSP Test Store - final”
​
email
string
required
Store contact email address. Example: “[email protected]”
​
phone_number
string
required
Store contact phone number in international format. Example: “+14132231249”
​
company_id
number
required
ID of the company this store belongs to. Example: 1000022
​
addresses
array
required
Array of address objects for different store purposes
​
create_bill_vendor
boolean
required
Whether to create a billing vendor account for this store. Set to true to enable automated billing setup.
​
point_of_contact
number
required
User ID of the primary point of contact for this store. Example: 1000049

​
Request Example

{
    "name": "SSP Test Store - final",
    "email": "[email protected]",
    "phone_number": "+14132231249",
    "company_id": 1000022,
    "addresses": [
        {
            "line_1": "123 Main Street",
            "city": "Philadelphia",
            "state": "PA",
            "zip": "19104",
            "address_type": 0
        },
        {
            "line_1": "201 S Main St. West Lebanon",
            "city": "Boston",
            "state": "NH",
            "zip": "03784",
            "address_type": 1
        }
    ],
    "create_bill_vendor": true,
    "point_of_contact": 1000049
}

​
Response

​
id
string
Unique store identifier (UUID format)
​
store_setup_completed
boolean
Indicates whether store setup process is complete
​
is_disabled
boolean
Store disabled status
​
is_rbac_store
boolean
Role-based access control enablement status
​
name
string
Store name as provided
​
email
string
Store contact email
​
phone_number
string
Store contact phone number
​
company_id
string
Associated company ID
​
point_of_contact
string
Point of contact user ID
​
bill_vendor_id
string
Generated billing vendor ID if create_bill_vendor was true
​
addresses
array
Array of created address records with full details including IDs
​
store_partners
array
Array of delivery service partner configurations (UberEats, DoorDash, GrubHub)
​
vendor
string
Associated vendor/billing ID

​
Response Example

{
    "id": "7669f473-6c40-45ee-8737-43c667407b3a",
    "store_setup_completed": false,
    "is_disabled": false,
    "is_rbac_store": false,
    "name": "SSP Test Store - final",
    "email": "[email protected]",
    "phone_number": "+14132231249",
    "company_id": "1000022",
    "point_of_contact": "1000049",
    "updatedAt": "2023-09-20T13:27:18.782Z",
    "createdAt": "2023-09-20T13:27:11.318Z",
    "bill_vendor_id": "00901CNUBBSWJZLLd82g",
    "addresses": [
        {
            "id": "f2641a24-c946-4421-9c95-107ecaa8b7af",
            "address": {
                "id": "8e48af24-7b57-4786-99f0-17a6a326cefc",
                "line_1": "123 Main Street",
                "city": "Philadelphia",
                "state": "PA",
                "zip": "19104"
            },
            "address_type": {
                "description": "Store Address",
                "address_type": 0
            }
        },
        {
            "id": "c47f36fa-e180-4df6-89fd-6ba89323d5a3",
            "address": {
                "id": "48dd9f57-7180-44a8-b106-dad325f52523",
                "line_1": "201 S Main St. West Lebanon",
                "city": "Boston",
                "state": "NH",
                "zip": "03784"
            },
            "address_type": {
                "description": "Welcome Package Address",
                "address_type": 1
            }
        }
    ],
    "store_partners": [
        {
            "id": "b8168479-5c75-4bd6-977c-eabad3a3a01c",
            "partner_name": "UberEats",
            "order_enabled": false,
            "menu_enabled": false,
            "pos_enabled": false
        },
        {
            "id": "23c1ec9c-bfd1-46d9-a0bc-bf4f456eba5b",
            "partner_name": "DoorDash",
            "order_enabled": false,
            "menu_enabled": false,
            "pos_enabled": false
        },
        {
            "id": "d142c4db-7910-471c-8c22-3f1d17fb3c19",
            "partner_name": "GrubHub",
            "order_enabled": false,
            "menu_enabled": false,
            "pos_enabled": false
        }
    ]
}
Automatic Partner Setup: The store is automatically configured with delivery service partners (UberEats, DoorDash, GrubHub) but they start in disabled state. You’ll need to configure each partner individually after store creation.
Address Types: Use address_type 0 for the main store address where operations happen, and address_type 1 for the address where welcome packages and onboarding materials should be shipped.
Point of Contact: Ensure the point_of_contact user ID exists and has appropriate permissions before creating the store.
Billing Vendor: When create_bill_vendor is true, a billing vendor account is automatically created and linked to the store for payment processing.