Webhooks

Last modified: April 09, 2025

Webhooks allow you to notify external services when your image is ready to download, or when a new has been created, updated, or deleted. Webhooks can be configured in the Webhooks configuration section of the RenderForm account and are triggered for all requests made to RenderForm API. You can also configure a webhook for a specific request by providing a webhookUrl parameter in the request body when rendering an image.

You can create up to 10 global webhooks.

Webhook actions

Webhooks can be triggered for the following actions:

  • RENDER_COMPLETE - when the image or PDF is ready to download
  • TEMPLATE_CREATE - when a new template is created
  • TEMPLATE_UPDATE - when a template is updated
  • TEMPLATE_DELETE - when a template is deleted

Action names are sent in the action field of the webhook payload.

Sample webhook payload

Webhooks are always sent via POST request. The payload is a JSON object with the following fields:

On image generation

{
    "action": "RENDER_COMPLETE",
    "requestId": "febbd34c-cadf-43e6-926c-5942016aea4e"
    "href": "https://cdn.renderform.io/8af2cacf-a328-4a8f-a4a7-fc6419b5b805/results/febbd34c-cadf-43e6-926c-5942016aea4e.jpg"
}

On template action

{
    "action": "TEMPLATE_CREATE", // or "TEMPLATE_UPDATE", "TEMPLATE_DELETE"
    "templateId": "hairy-newts-chuckle-blindly-7342",
    "name": "Social Media Cover",
}

You can use websites like Webhook.site to test webhooks.