Create store — final bootstrap step

import requests
url = "https://api.listbee.so/v1/bootstrap/store"
payload = {
    "session": "sess_abc123",
    "store_name": "Acme Agency"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "id": "st_7kQ2xY9mN3pR5tW1vB8a",
  "display_name": "Acme Agency",
  "slug": "acme-agency",
  "url": "https://buy.listbee.so/acme-agency",
  "readiness": {
    "sellable": false,
    "actions": [
      {
        "code": "connect_stripe",
        "kind": "api",
        "priority": "required",
        "message": "Set Stripe secret key to accept payments",
        "resolve": {
          "method": "POST",
          "endpoint": "/v1/account/stripe-key",
          "url": "https://console.listbee.so/connect/stripe",
          "params": {
            "secret_key": "sk_live_..."
          }
        }
      }
    ],
    "next": "connect_stripe"
  },
  "object": "store",
  "bio": "We make great things.",
  "has_avatar": false,
  "api_key": "lb_abc123"
}

Step 3 of 3. Create a store on a verified bootstrap session. Returns the store object with a one-time api_key — store this immediately, it will not be shown again. Use the API key as Authorization: Bearer lb_... for all subsequent API calls. Public endpoint — no API key required.

Request

This endpoint expects an object.

sessionstringRequired

Verified session ID from bootstrap step 2

store_namestringRequired1-200 characters

Display name for the store

Response

Successful Response

idstring

Unique store ID (st_ prefixed).

display_namestring

Store display name shown to buyers.

slugstring

URL-safe store slug used in checkout URLs.

urlstring

Public store URL.

readinessobject

Store readiness. Check actions for what’s needed before you can sell.

object"store"

Object type identifier. Always store.

biostring or null

Store bio shown on product pages.

has_avatarbooleanDefaults to false

True if an avatar image has been uploaded.

api_keystring or null

Raw API key, shown once at creation. Use as Bearer token.

Errors

400

Bad Request Error

422

Unprocessable Entity Error