Webhooks - ffmpeg-api-cloud

Use webhooks when you do not want to poll for job completion.

How it works

Send webhookUrl when you create a job.
The API runs your FFmpeg or FFprobe command asynchronously.
Your endpoint receives a signed event when the job finishes.

Create a job with a webhook

curl -X POST https://ffmpeg-api.cloud/v1/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "binary": "ffprobe",
    "webhookUrl": "https://your-app.example.com/webhooks/ffmpeg",
    "input": [
      {
        "type": "url",
        "url": "https://example.com/input.mp4"
      }
    ],
    "ffmpegArgs": [
      "-v",
      "error",
      "-show_format",
      "-show_streams",
      "-of",
      "json",
      "input0"
    ]
  }'

Test your webhook endpoint

Use the webhook test endpoint before wiring production jobs.

curl -X POST https://ffmpeg-api.cloud/v1/webhooks/test \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.example.com/webhooks/ffmpeg"
  }'

Next

See /api-reference/overview for authentication and response conventions.
See the generated API pages for endpoint fields and payload schemas.