Callback Delivery (Under 4.5 MB)

After your AI automation processes an order, you must send the results back to SellerShorts using our callback endpoint. This completes the order and delivers results to the buyer.

📚 Before you start: Read Callback Basics for required fields, authentication, and response codes.

Callback flow: 1. Process the job. 2. POST /api/orders/callback with JSON payload (text, URL, or base64 file).

⚠️ Note: This guide is for payloads under 4.5 MB. For larger files, use the Callback (Over 4.5 MB) guide.

Payload formats

Send Text/Content

Use this format when sending text, JSON, or CSV content directly in the payload. The result_text field is required when using output_type: text, json, or csv.

Note: The 4.5 MB total payload limit applies to your entire JSON request body (including all fields and content). For larger content, use the Callback (Over 4.5 MB) guide.

💡 For HTML content: Use output_type: "url" instead. Host your HTML file and return the URL. This provides better performance, no size limits, and full control over your content.

Output types for text content

The output_type field can be one of:

text - Plain text content
json - JSON data
csv - CSV data

Examples

⚠️ Important: These are template examples. Replace all placeholders with real values:

order-uuid-from-webhook → Use the actual order_id from your webhook payload
Include the x-callback-secret header in your request (see cURL example below)

Plain text

{
  "ok": true,
  "order_id": "order-uuid-from-webhook",
  "output_type": "text",
  "result_text": "Your analysis results go here..."
}

JSON data

{
  "ok": true,
  "order_id": "order-uuid-from-webhook",
  "output_type": "json",
  "result_text": "{\"status\": \"success\", \"data\": [1, 2, 3]}"
}

CSV data

{
  "ok": true,
  "order_id": "order-uuid-from-webhook",
  "output_type": "csv",
  "result_text": "Name,Age,City\nJohn,30,New York\nJane,25,Los Angeles"
}

Testing with cURL

curl -X POST "https://api.example.com/callback" \
  -H "Content-Type: application/json" \
  -H "x-callback-secret: your-callback-secret" \
  -d '{
    "ok": true,
    "order_id": "test-order-uuid",
    "output_type": "text",
    "result_text": "Analysis completed successfully..."
  }'

Required fields (all versions)

ok: true for success, false for failure
order_id: UUID from the original webhook payload

Success fields (v1)

output_type: One of text, json, csv, file, xlsx, url, video
result_text: Required when using output_type: text, json, or csv. Contains the actual content as a string.