Webhook Notifications

Configure a webhook URL to automatically receive a POST callback when a render finishes (success or failure). You can set the URL in the Render Console or programmatically.

Set or Update Webhook URL

set-webhook.sh
1curl -X POST https://render-api.chillin.online/user/webhook \ 2-H "Accept: application/json" \ 3-H "Content-Type: application/json" \ 4-H "Authorization: Bearer YOUR_API_KEY" \ 5-d '{"url": "https://your-domain.com/webhook"}'

Trigger a Test Delivery

test-webhook.sh
1curl -X POST https://render-api.chillin.online/user/webhook/test \ 2-H "Accept: application/json" \ 3-H "Content-Type: application/json" \ 4-H "Authorization: Bearer YOUR_API_KEY" \ 5-d '{"url": "https://your-domain.com/webhook"}'

Webhook Payload

webhook_payload.json
1{ 2"render_id": 123, 3"user_id": 456, 4"status": "success", 5"video_url": "https://cloud.chillin.online/video_xxx.mp4", 6"json_url": "https://cloud.chillin.online/project_xxx.json", 7"error_message": "", 8"error_log_url": "", 9"cost": 0.05, 10"duration": 10.5, 11"finished_at": "2024-01-01T12:00:00Z" 12} 13
  • The callback is a JSON POST request sent immediately after the render finishes.
  • Respond within 5 seconds; timeouts are not retried.
  • Use the status field (success or failed) alongside error_message/error_log_url to handle failures gracefully.