Core Concepts

Deliverables

A deliverable is the digital content attached to a listing. You set the type explicitly using the PUT /v1/listings/{id}/deliverable endpoint. ListBee handles delivery automatically when using managed fulfillment.

Deliverables are one axis of the fulfillment model. The other is the fulfillment mode (managed vs external), which is computed from whether a deliverable is attached.

Deliverable typeFulfillment modeResult
FILE / URL / TEXTManagedListBee delivers automatically
FILE / URL / TEXTExternalContent stored but your app handles delivery
NoneExternalNo content on listing — your app delivers everything

Deliverables are mutable. Call PUT again to replace, or DELETE /v1/listings/{id}/deliverable to remove. Draft only — returns 409 if published.

FILE

A file upload. Upload the file first via POST /v1/files, then attach the returned file token to the listing.

Examples: PDF, ZIP, EPUB, MP3, dataset, software binary.

Delivery: ListBee serves the file from a CDN and generates a signed time-limited download URL. The buyer receives an email with the link. Expires after 24 hours.

$# Upload the file
$curl -X POST https://api.listbee.so/v1/files \
>  -H "Authorization: Bearer lb_..." \
>  -F "file=@advanced-python.pdf"
$# → { "object": "file", "id": "file_..." }
$
$# Attach to listing
$curl -X PUT https://api.listbee.so/v1/listings/lst_.../deliverable \
>  -H "Authorization: Bearer lb_..." \
>  -H "Content-Type: application/json" \
>  -d '{"type": "file", "token": "file_..."}'

URL

A URL that points to a web page.

Examples: Notion page, Google Doc, gated article, course login page.

Delivery: After payment, the buyer receives an email with a link. Clicking it redirects to your URL. ListBee does not cache the page content.

$curl -X PUT https://api.listbee.so/v1/listings/lst_.../deliverable \
>  -H "Authorization: Bearer lb_..." \
>  -H "Content-Type: application/json" \
>  -d '{"type": "url", "value": "https://www.notion.so/your-page-id"}'

TEXT

Plain text — a license key, API key, password, code snippet, discount code.

Delivery: After payment, the text is shown on the confirmation page and included in the buyer email.

$curl -X PUT https://api.listbee.so/v1/listings/lst_.../deliverable \
>  -H "Authorization: Bearer lb_..." \
>  -H "Content-Type: application/json" \
>  -d '{"type": "text", "value": "LICENSE-KEY-ABCD-1234-EFGH-5678"}'

No deliverable (external only)

Don’t attach a deliverable. The listing uses external fulfillment — your app delivers after payment.

Summary

TypeHow to setAfter purchase (managed)
fileUpload via POST /v1/files, then PUT with tokenSigned CDN download URL, expires 24h
urlPUT with type: "url" and valueRedirect to your URL
textPUT with type: "text" and valueText shown inline in email
nullNo deliverable attachedYour app delivers

Next steps

Copy for AI assistants

$# ListBee — deliverables
$#
$# Attach digital content to a listing using PUT /v1/listings/{id}/deliverable
$# Type is set explicitly — not auto-detected.
$#
$# FILE (upload first, then attach):
$#   POST /v1/files  (multipart/form-data, field: "file")
$#   → { "object": "file", "id": "file_..." }
$#   PUT /v1/listings/{id}/deliverable  { "type": "file", "token": "file_..." }
$#
$# URL (web page redirect after purchase):
$#   PUT /v1/listings/{id}/deliverable  { "type": "url", "value": "https://..." }
$#
$# TEXT (license key, password, code snippet):
$#   PUT /v1/listings/{id}/deliverable  { "type": "text", "value": "..." }
$#
$# Remove deliverable:
$#   DELETE /v1/listings/{id}/deliverable
$#
$# Mutability: PUT replaces, DELETE removes. Draft only — 409 if published.
$#
$# deliverable_type values:
$#   "file" — CDN-hosted, signed download URL (24h)
$#   "url"  — redirect after purchase
$#   "text" — inline text in buyer email
$#   null   — no deliverable (external fulfillment)
$#
$# Two-axis model:
$#   deliverable_type (file/url/text/null) × fulfillment (managed/external)
$#   managed + file/url/text → ListBee delivers automatically
$#   external + any          → your app delivers (can use fulfill callback)
$#
$# Auth: Authorization: Bearer lb_...
$# Docs: https://docs.listbee.so/deliverables