Exports Operations

Why You Would Use This

Exports are asynchronous jobs. Understanding the lifecycle helps you automate reliably and set correct expectations for large date ranges.

Job Lifecycle

1. Create export job.
2. Poll job status (pending or processing).
3. Download when status is completed.
4. Handle failed and expired states with retry or regeneration.

Console Workflow

1. Start export from Messages with filters applied.
2. Open Exports to monitor progress.
3. Refresh or wait for automatic updates while jobs are active.
4. Download completed files.

If export-ready email notifications are enabled for your deployment/user context, you may also receive an email when the export is complete.

API Workflow

# Create export
curl -X POST https://api.hookbridge.io/v1/exports \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "direction": "outbound",
    "start_time": "2026-02-01T00:00:00Z",
    "end_time": "2026-02-25T23:59:59Z",
    "status": "failed_permanent"
  }'

# List exports
curl https://api.hookbridge.io/v1/exports \
  -H "Authorization: Bearer YOUR_API_KEY"

# Get export status
curl https://api.hookbridge.io/v1/exports/YOUR_EXPORT_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

# Download export
curl -L https://api.hookbridge.io/v1/exports/YOUR_EXPORT_ID/download \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o export.csv