Publish listing

Validate and publish a draft listing. Transitions to published state — the listing becomes live, buyable, and immutable. Fails with 409 and readiness actions if requirements are not met.

Authentication

AuthorizationBearer

API key (lb_ prefix). Pass as: Authorization: Bearer lb_...

Path parameters

listing_idstringRequired

Listing ID (lst_ prefixed).

Response

Successful Response

idstring

Unique listing ID (lst_ prefixed).

slugstring

URL slug for the product page

namestring

Product name shown on the product page

highlightslist of strings

Bullet-point features shown as badges on the product page.

priceinteger

Price in cents (smallest currency unit). Examples: $5 = 500,$ 29 = 2900, $99.99 = 9999.

has_deliverablesboolean

True if deliverables are attached and have content. Determines post-payment behavior: true = ListBee auto-delivers, false = webhook/fulfillment_url fires.

has_coverboolean

True if a cover image exists (uploaded or generated)

statusenum

Current listing status. Values: draft (editable, not yet live), published (live, accepting orders), deleted (soft-deleted).

Allowed values:

readinessobject

Monetization readiness. sellable is true when buyers can complete a purchase. If false, actions lists what’s needed with kind (api/human), resolve details, and next points to the highest-priority action.

created_atdatetime

Time at which the listing was created

object"listing"

Object type identifier. Always listing.

descriptionstring or null

Product description shown on the product page. Plain text.

taglinestring or null

Short tagline shown below the product name on the product page.

ctastring or null

Buy button text on the product page. Defaults to 'Buy Now' if omitted.

deliverableslist of objects

Deliverables pre-attached to this listing. When present, ListBee auto-delivers them to buyers on payment. When empty, payment fires webhooks and fulfillment_url — your system handles delivery.

fulfillment_urlstring or null

Per-listing callback URL. ListBee POSTs enriched order payload here on purchase.

checkout_schemalist of objects or null

Custom fields collected from the buyer at checkout

compare_at_priceinteger or null

Strikethrough price in smallest currency unit

badgeslist of strings

Short promotional badges shown on the product page (e.g. ‘Best seller’, ‘Limited time’).

cover_blurenum

Cover image blur mode. 'true' always blurs, 'false' never blurs, 'auto' blurs when deliverable is an image file.

Allowed values:

ratingdouble or null

Seller-provided aggregate star rating (1-5). Shown on the product page.

rating_countinteger or null

Seller-provided review or purchase count shown alongside the rating on the product page.

reviewslist of objects

Featured review cards shown on the product page. Seller-provided, not buyer-submitted.

faqslist of objects

FAQ accordion shown on the product page. Answers common buyer questions.

metadatamap from strings to any or null

Arbitrary key-value pairs forwarded in webhook event payloads. Set at creation or update.

utm_sourcestring or null

UTM source tag for Google Analytics

utm_mediumstring or null

UTM medium tag for Google Analytics

utm_campaignstring or null

UTM campaign tag for Google Analytics

stockinteger or null

Stock quantity. null = unlimited, 0 = out of stock. Auto-decrements on each order.

urlstring or null

Full product page URL — share this with buyers

embed_urlstring or null

Embeddable product page URL — use in iframes. Renders minimal version without header/footer.

Errors

401

Unauthorized Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

1	import requests
2
3	url = "https://api.listbee.so/v1/listings/listing_id/publish"
4
5	headers = {"Authorization": "Bearer <token>"}
6
7	response = requests.post(url, headers=headers)
8
9	print(response.json())

1	{
2	"id": "lst_7kQ2xY9mN3pR5tW1vB8a",
3	"slug": "seo-playbook",
4	"name": "SEO Playbook 2026",
5	"highlights": [
6	"50+ pages",
7	"Actionable tips"
8	],
9	"price": 500,
10	"has_deliverables": true,
11	"has_cover": true,
12	"status": "published",
13	"readiness": {
14	"sellable": true,
15	"actions": [
16	{
17	"code": "connect_stripe",
18	"kind": "api",
19	"priority": "required",
20	"message": "Set Stripe secret key to accept payments",
21	"resolve": {
22	"method": "POST",
23	"endpoint": "/v1/account/stripe-key",
24	"url": "https://console.listbee.so/connect/stripe",
25	"params": {
26	"secret_key": "sk_live_..."
27	}
28	}
29	}
30	],
31	"next": "connect_stripe"
32	},
33	"created_at": "2026-04-01T12:00:00Z",
34	"object": "listing",
35	"description": "A comprehensive guide to modern SEO.",
36	"tagline": "Updated for 2026 algorithm changes",
37	"cta": "Get Instant Access",
38	"deliverables": [
39	{
40	"id": "del_7kQ2xY9mN3pR5tW1vB8a01",
41	"type": "file",
42	"status": "ready",
43	"object": "deliverable",
44	"filename": "ebook.pdf",
45	"size": 2458631,
46	"mime_type": "application/pdf",
47	"url": "https://example.com/secret",
48	"content": "Buy signal: AAPL"
49	}
50	],
51	"fulfillment_url": "https://my-agent.com/fulfill",
52	"checkout_schema": [
53	{
54	"key": "size",
55	"type": "text",
56	"label": "Shoe size",
57	"required": true,
58	"options": [
59	"S",
60	"M",
61	"L"
62	],
63	"sort_order": 0
64	}
65	],
66	"compare_at_price": 3900,
67	"badges": [
68	"Limited time"
69	],
70	"cover_blur": "auto",
71	"rating": 4.8,
72	"rating_count": 1243,
73	"reviews": [],
74	"faqs": [],
75	"metadata": {
76	"source": "n8n"
77	},
78	"utm_source": "google",
79	"utm_medium": "cpc",
80	"utm_campaign": "spring-sale",
81	"url": "https://buy.listbee.so/seo-playbook",
82	"embed_url": "https://buy.listbee.so/seo-playbook?embed=true"
83	}