Add deliverable

Add a single deliverable to a draft listing. Appends to the existing array. Returns the new deliverable with a unique del_ prefixed ID. Max 3 deliverables per listing — returns 409 if at capacity.

Authentication

AuthorizationBearer

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

Path parameters

listing_idstringRequired

Listing ID (lst_ prefixed).

Request

This endpoint expects an object.

typeenumRequired

Deliverable type: file (uploaded via POST /v1/files), url (redirect), or text (literal string).

Allowed values:

tokenstring or nullOptional

File token from POST /v1/files. Required when type is file.

valuestring or nullOptional

URL (https required) or text content. Required when type is url or text.

Response

Successful Response

idstring

Unique deliverable identifier (del_ prefixed).

typeenum

Deliverable type.

Allowed values:

statusenum

Processing status.

Allowed values:

object"deliverable"

Object type identifier.

filenamestring or null

Original filename (file type only).

sizeinteger or null

File size in bytes (file type only).

mime_typestring or null

MIME type (file type only).

urlstring or null

Redirect URL (url type only).

contentstring or null

Text content (text type only).

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/deliverables"
4
5	payload = {
6	"type": "file",
7	"token": "file_7kQ2xY9mN3pR5tW1vB8a01",
8	"value": "https://example.com/secret-area"
9	}
10	headers = {
11	"Authorization": "Bearer <token>",
12	"Content-Type": "application/json"
13	}
14
15	response = requests.post(url, json=payload, headers=headers)
16
17	print(response.json())

1	{
2	"id": "del_7kQ2xY9mN3pR5tW1vB8a01",
3	"type": "file",
4	"status": "ready",
5	"object": "deliverable",
6	"filename": "ebook.pdf",
7	"size": 2458631,
8	"mime_type": "application/pdf",
9	"url": "https://example.com/secret",
10	"content": "Buy signal: AAPL"
11	}