Create Store

Create Store

curl --request POST \
  --url https://api-staging.luladelivery.store/stores/store/

const options = {method: 'POST'};

fetch('https://api-staging.luladelivery.store/stores/store/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-staging.luladelivery.store/stores/store/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api-staging.luladelivery.store/stores/store/"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api-staging.luladelivery.store/stores/store/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

{
  "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>"
}

POST

stores

store

Create Store

curl --request POST \
  --url https://api-staging.luladelivery.store/stores/store/

const options = {method: 'POST'};

fetch('https://api-staging.luladelivery.store/stores/store/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-staging.luladelivery.store/stores/store/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api-staging.luladelivery.store/stores/store/"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api-staging.luladelivery.store/stores/store/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

{
  "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>"
}

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.

Request Body Fields

string

required

Store name as it will appear to customers. Example: “SSP Test Store - final”

string

required

Store contact email address. Example: “[email protected]”

string

required

Store contact phone number in international format. Example: “+14132231249”

number

required

ID of the company this store belongs to. Example: 1000022

array

required

Array of address objects for different store purposes

Show Address Object

string

required

Primary address line. Example: “123 Main Street”

string

required

City name. Example: “Philadelphia”

string

required

State or province. Example: “PA”

string

required

ZIP or postal code. Example: “19104”

number

required

Type of address:

0 = Store Address (main operational address)
1 = Welcome Package Address (shipping address for onboarding materials)

boolean

required

Whether to create a billing vendor account for this store. Set to true to enable automated billing setup.

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

string

Unique store identifier (UUID format)

boolean

Indicates whether store setup process is complete

boolean

Store disabled status

boolean

Role-based access control enablement status

string

Store name as provided

string

Store contact email

string

Store contact phone number

string

Associated company ID

string

Point of contact user ID

string

Generated billing vendor ID if create_bill_vendor was true

array

Array of created address records with full details including IDs

array

Array of delivery service partner configurations (UberEats, DoorDash, GrubHub)

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.

API Documentation - Legacy

API Documentation - Latest

Request Example

Response

Response Example

​Request Example

​Response

​Response Example

Request Example

Response

Response Example