Bulk Upload

Outcome: Create multiple AI Short drafts quickly by uploading basic information in bulk, then complete each one individually.

The Bulk Upload feature allows experienced sellers to create up to 100 AI Short drafts at once by uploading basic field information via Excel template. This is ideal for sellers who want to quickly create multiple drafts and then complete them individually with detailed configurations.

Overview

Bulk Upload is designed for speed and efficiency. It creates draft AI Shorts with basic information only, allowing you to quickly establish multiple listings that you can then complete individually through the standard workflow.

When to use Bulk Upload

• You have multiple AI Shorts to create – Save time on repetitive basic field entry
• You understand the submission process – You're familiar with all required fields and steps
• You want to batch create drafts – Plan to complete them over time
• You have basic information ready – Names, descriptions, categories, platforms, prices

When NOT to use Bulk Upload

• First-time seller – Use Individual Wizard to learn the process
• Complex AI Short – Use Individual Wizard for detailed setup
• Need immediate submission – Bulk Upload creates drafts, not completed submissions
• Want to test immediately – Use Individual Wizard for immediate testing

How Bulk Upload works

1. Download the Excel template – Get the template with all required fields
2. Fill out basic information – Add names, descriptions, categories, platforms, prices
3. Upload the completed file – System validates and creates drafts
4. Complete each draft individually – Add inputs, outputs, connections, test, and submit

Excel Template Fields

Required Fields

• name – AI Short name (2-60 characters)
• short_pitch – Brief description (10-120 characters)
• category – Choose from predefined categories
• platform – Target platform or marketplace
• price_cents – Price in cents (e.g., 500 for $5.00)
• description – Full description (20-4000 characters)
• eta_bucket – Processing time estimate
• webhook_url – Your webhook endpoint URL (must start with https://)
• input_schema – Input field definitions in JSON format

Optional Fields

• use_cases – Up to 8 specific use cases
• output_examples – Up to 2 output examples
• output_type – Type of output (text, csv, html, json, file, url, xlsx, video)

Template Validation

The Excel template includes:

• Dropdown lists – For categories, platforms, output types, and ETA buckets
• Field validation – Character limits and required field indicators
• Reference guide – Complete list of valid values and examples
• Format examples – Sample data to guide your entries

Upload Process

1. Select your file – Choose the completed Excel template
2. Validation – System checks all fields and data
3. Results – Field-level validation errors (if any)
4. Draft creation – Successful rows become draft AI Shorts
5. Next steps – Complete each draft individually

After Upload

Once your upload is complete:

1. View drafts – Check "Your Drafts" section in dashboard
2. Complete each draft – Add missing fields through the individual workflow
3. Add inputs and outputs – Define what buyers provide and receive
4. Set up connections – Configure webhooks and callbacks
5. Test functionality – Verify everything works correctly
6. Submit for review – Complete the approval process

Common Issues

Upload Errors

• Invalid category – Use exact values from the dropdown list
• Invalid platform – Choose from predefined platform options
• Price format – Enter whole numbers in cents (500 = $5.00)
• Missing required fields – All required fields must be filled
• Character limits – Check length requirements for each field

Draft Completion Issues

• Missing inputs – Define what buyers need to provide
• No output configuration – Specify what buyers will receive
• No webhook setup – Configure where to receive buyer inputs
• No callback URL – Set up how to send results back

Best Practices

• Start small – Test with 5-10 AI Shorts before doing large batches
• Use consistent naming – Follow a clear naming convention
• Complete drafts quickly – Don't let drafts sit unfinished
• Test each AI Short – Verify functionality before submission
• Price appropriately – Consider value and processing time

Template Structure (4 Sheets)

The Excel template contains four sheets:

• Sheet 1 - AI Shorts Template: Fill this sheet with your AI Short data (headers only, no sample data)
• Sheet 2 - Reference Guide: Contains all valid categories, platforms, output types, and field definitions
• Sheet 3 - Input Schema Guide: Complete documentation for all 19 input field types with JSON examples
• Sheet 4 - Sample Data Examples: Reference examples for testing (copy to Sheet 1)

Template Tips

• Use the reference guide – Check Sheet 2 for valid values
• Follow examples – Use the provided format examples in Sheet 4
• Validate data – Use Excel's dropdown lists to avoid errors
• Save frequently – Keep backups of your work

What's next?

After creating drafts through bulk upload, visit the Dashboard section to learn about managing your drafts, then explore the individual workflow steps to complete each AI Short.

Input Schema Field Reference

Understanding the JSON Format

Each input field is defined as a JSON object with these properties:

Field Properties

• "key" – The unique name your webhook receives for this field (use lowercase with underscores)
• "type" – The kind of input field buyers will see (see complete list below)
• "label" – The text buyers see above the input field
• "required" – Whether buyers must fill this field (true/false)
• "placeholder" – Example text shown inside the input field

Complete Field Types Reference

Text Fields (4 types)

• text – Single line text input
• textarea – Multi-line text input
• url – URL input with validation
• tags – Free-text list (chips)

Numeric Fields (1 type)

• number – Numeric input

Choice Fields (5 types)

• select – Dropdown selection
• multiselect – Multiple choice selection
• boolean – Yes/No checkbox
• date – Single date picker (YYYY-MM-DD)
• date_range – Start and end date selection

File Upload Fields (9 types)

• file_csv – CSV file upload (20MB limit)
• file_json – JSON file upload (5MB limit)
• file_xlsx – Excel file upload (20MB limit)
• file_pdf – PDF file upload (30MB limit)
• file_image – Image file upload (15MB limit) - PNG, JPG, WebP
• file_docx – DOCX file upload (22MB limit)
• file_txt – Text file upload (5MB limit)
• file_video – Video file upload (100MB limit) - MP4, MOV, WebM, AVI
• file_audio – Audio file upload (50MB limit) - MP3, WAV, AAC, OGG

Input Schema Examples

Single Field Examples

[{"key": "product_url", "type": "url", "label": "Product URL", "required": true, "placeholder": "Enter Amazon product URL"}]

[{"key": "csv_file", "type": "file_csv", "label": "CSV File", "required": true, "placeholder": "Upload your CSV file"}]

Multiple Fields Examples

Template (3 fields)

[
  {"key": "product_url", "type": "url", "label": "Product URL", "required": true, "placeholder": "Enter Amazon product URL"},
  {"key": "keywords", "type": "text", "label": "Target Keywords", "required": false, "placeholder": "Enter keywords separated by commas"},
  {"key": "csv_file", "type": "file_csv", "label": "Product Data CSV", "required": false, "placeholder": "Upload your CSV file"}
]

SEO Analysis Template (4 fields)

[
  {"key": "website_url", "type": "url", "label": "Website URL", "required": true, "placeholder": "Enter your website URL"},
  {"key": "target_keywords", "type": "text", "label": "Target Keywords", "required": true, "placeholder": "Enter keywords separated by commas"},
  {"key": "competitor_urls", "type": "textarea", "label": "Competitor URLs", "required": false, "placeholder": "Enter competitor URLs, one per line"},
  {"key": "analysis_type", "type": "select", "label": "Analysis Type", "required": true, "placeholder": "Select analysis type"}
]

Document Processing Template (5 fields)

[
  {"key": "pdf_document", "type": "file_pdf", "label": "PDF Document", "required": true, "placeholder": "Upload your PDF file"},
  {"key": "word_document", "type": "file_docx", "label": "Word Document", "required": false, "placeholder": "Upload your DOCX file"},
  {"key": "processing_type", "type": "select", "label": "Processing Type", "required": true, "placeholder": "Select processing type"},
  {"key": "output_format", "type": "select", "label": "Output Format", "required": true, "placeholder": "Select output format"},
  {"key": "include_images", "type": "boolean", "label": "Include Images", "required": false, "placeholder": "Check to include images"}
]

Validation Rules

• Webhook URL: Must start with https://
• Input Schema: Must be valid JSON array format
• Copy templates exactly: No line breaks or extra spaces
• Each field needs unique key: No duplicate field names
• File size limits: Respect the limits for each file type
• Maximum 20 input fields per AI Short

Excel Template Update Instructions

To use the expanded bulk upload feature, add these 2 new columns to your Excel template:

1. webhook_url – Add as column 11
2. input_schema – Add as column 12

Copy the JSON examples above exactly as shown for the input_schema column.