Long-running functions with webhooks

Key facts

Works with

Every 1001fx function, from any tool that sends HTTPS requests

Headers

x-fx-webhook (your HTTPS URL) and x-fx-webhook-ref (your reference ID, up to 255 characters)

Costs

The usual function credits, only on success, plus 1 credit per call with webhook. Retries are free.

Run time

Up to 30 minutes per job

Retries

After 1 minute, 5 minutes, 30 minutes, 2 hours and 6 hours on network errors, 5xx, 408 or 429

Security

Optional HMAC-SHA256 signature in x-fx-signature with your own signing secret

Status

GET /jobs/<jobId> with the same API key, free of charge

File results

Delivered as download URL, kept for 48 hours

Available via

REST API (https://api.1001fx.com) with your API key – from Make, n8n, scripts and AI agents

What you can do with it

• Extract audio from videos, transcribe recordings or process large files that take minutes
• Avoid the timeouts of automation platforms such as Make and n8n, which stop waiting for an answer after a while
• Start many jobs at once and collect the results in a second scenario or workflow
• Match each result to your data with the reference ID, for example a spreadsheet row

How it works

1. 1

   Call the function as usual and add the headers x-fx-webhook and x-fx-webhook-ref.

2. 2

   Input errors (400), a wrong key (401) or too few credits (402) come back at once, without a job.

3. 3

   Otherwise 1001fx answers 202 with a jobId and runs the function in the background.

4. 4

   When the function is done, 1001fx posts the result, the credits and the duration to your webhook URL.

Functions

Each function has its own page with all parameters, examples and a ready-to-copy curl command.

Example

curl -X POST 'https://api.1001fx.com/audiovideo/extractaudio' \
  -H 'X-API-KEY: YOURSECRETAPIKEY' \
  -H 'x-fx-webhook: https://hook.eu1.make.com/abc123' \
  -H 'x-fx-webhook-ref: row-42' \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com/video.mp4"}'

HTTP/1.1 202 Accepted

{
  "jobId": "01JC8Z4M3Q7Y1V2X9K5T6R8N0P",
  "status": "queued",
  "ref": "row-42",
  "statusUrl": "https://api.1001fx.com/jobs/01JC8Z4M3Q7Y1V2X9K5T6R8N0P"
}

Frequently asked questions

What happens without the x-fx-webhook header?

Nothing changes. The call is answered directly, exactly as before.

Do I get a webhook when the function fails?

Yes. The webhook body then has "status": "failed", the status code and the error message. The function credits are not charged, only the 1 webhook credit.

Can the same result arrive twice?

Yes, for example when the answer of your webhook got lost. Use the jobId to ignore duplicates.

How do I check a job without a webhook?

Call GET /jobs/<jobId> with the same API key. While the job runs the status is queued or running; afterwards you get the same body as the webhook. The call is free.