Webhooks Overview

AudioSpliter can notify your application when jobs complete, fail, or reach other milestones via webhook HTTP callbacks.

How Webhooks Work

1. Include a webhookUrl when creating a split job
2. AudioSpliter sends a POST request to your URL when the job status changes
3. Your server responds with 200 OK to acknowledge receipt
4. If delivery fails, AudioSpliter retries with exponential backoff

Supported Events

Event	Description
job.completed	Job finished successfully, segments are ready
job.failed	Job failed during processing
job.progress	Progress update (optional, for large files)

Quick Example

When creating a job, include the webhook URL:

curl -X POST https://api.audiospliter.com/api/v1/splits \
  -H "X-API-Key: as_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceUrl": "https://example.com/audio.mp3",
    "splitMode": "duration",
    "segmentDuration": 300,
    "webhookUrl": "https://your-app.com/webhooks/audiospliter"
  }'

Your endpoint receives:

{
  "event": "job.completed",
  "jobId": "job_abc123",
  "timestamp": "2026-03-29T10:05:00Z",
  "data": {
    "status": "completed",
    "segments": [
      {
        "index": 0,
        "downloadUrl": "https://cdn.audiospliter.com/segments/abc123-0.mp3",
        "duration": 300,
        "size": 4800000
      }
    ]
  }
}

Security

Every webhook request includes a signature in the X-AudioSpliter-Signature header. Always verify this signature before processing the payload. See Signature Verification for details.

Learn More

• Payload Format -- Full webhook payload schema
• Signature Verification -- How to verify webhook authenticity
• Retry Policy -- Retry schedule and failure handling
• Using Webhooks Guide -- Step-by-step implementation guide