For the /async endpoints the webhook property comes into play. This feature proves valuable when waiting for the result isn’t necessary. Your application can attend to other tasks, and a notification will be triggered upon completion of the render.

All you need to do is specify a URL to receive the data, and the response will automatically be directed to that endpoint once the request concludes. Various HTTP methods like POST or PUT can be used, you can also choose to receive the document in base64 or an temporary url to download the file.

See also Securing your webhook on how to improve your webhooks security and Webhook event for the payload that will be sent to your webhook.

​
Available on endpoints:

url
string
required

The webhook's URL. Should include the scheme, e.g. https://

receiveType
enum<string>
default: URL

The way this webhook wants to receive the result.

  • When URL is used an temporary URL will be provided to download the file (the file will be automatically deleted after 1 hour).
  • When base64 is used make sure your webhook can receive the size of the file!
Available options:
base64,
URL
method
enum<string>
default: POST

Method to use when calling the webhook.

Available options:
POST,
PUT
headers
object | null

An object containing additional HTTP headers to be sent with the webhook. All header values must be strings.

metadata
object | null

Additional metadata that will be inside the request when the webhook is called. All values must be strings. Max 1kB.

Was this page helpful?

Storage optionsWebhook event