Send fax callback

When Phaxio is done processing your fax, it will post the job’s status to your send fax callback URL, if one is available. You can set up a send callback URL on the callbacks page in the web console, or specify one directly in your send API call.

If you’ve specified a global callback URL on the callbacks page and also make a send API call with a callback url specified, the API call’s URL will override the global one.

The callback HTTP request is a multipart POST and should be processed like a form submission.

If a callback fails, we will automatically retry the callback up to 16 times. There will be a backoff before each retry, which increases as follows:

Retry No. Backoff
1 5 minutes
2 10 minutes
3 20 minutes
4 30 minutes
5-16 6 hours

Request Parameters

A send callback includes all Fax Object parameters, as well as the following:

Name Type Description
success boolean Was the fax sent successfully?
is_test boolean Is this callback as a result of a test call?
direction string The direction of the fax (in this case, 'sent'). Useful if you use the same callback URL for both sent and receive confirmations.