---
title: "Set webhook configuration"
method: PUT
path: "/webhook-config"
tags: ["Webhooks"]
---

# Set webhook configuration

`PUT /webhook-config`

## Request

- Base URL: `https://renderio.dev/api/v1`
- URL: `https://renderio.dev/api/v1/webhook-config`
- Auth: API key in header `X-API-KEY`

## Request body

- SetWebhookConfigRequest
  - `url` string, uri, required
  - `secret` string: Shared secret used to sign the delivery with an HMAC signature header.

## Response `200`

Webhook configured

- WebhookConfigUpdated
  - `success` boolean, required
  - `url` string, uri, required

## Other responses

- `401`: Missing or invalid API key
- `403`: Plan does not include this capability
- `422`: Request failed validation
- `429`: Rate limit exceeded — retry after the `Retry-After` interval

---

[API](https://skmtc.dev/renderio/apis/renderio-api.md) · [All operations](https://skmtc.dev/renderio/apis/renderio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/renderio/apis/renderio-api/revisions/062c8f1c062b?raw)