---
title: "Update Webhook Integration"
method: PUT
path: "/open/forms/{form}/integrations/{integrationid}"
tags: ["Integrations"]
---

# Update Webhook Integration

`PUT /open/forms/{form}/integrations/{integrationid}`

Update an existing webhook integration. Requires `manage-integrations` ability.

## Path parameters

- `form` number, required — The ID of the form.
- `integrationid` number, required — The ID of the integration.

## Request body

- object
  - `integration_id` 'webhook', required — Must be "webhook"
  - `status` 'active' | 'inactive' — The status of the webhook
  - `data` object, required
    - `webhook_url` string, uri, required — The URL where submissions will be sent

## Response `200`

Webhook updated successfully

- object
  - `message` string
  - `form_integration` FormIntegration
    - `id` number — Unique identifier for the integration.
    - `form_id` number — The ID of the associated form.
    - `integration_id` string — Type of integration (currently only "webhook" is exposed via API).
    - `status` 'active' | 'inactive' — Whether the integration is active.
    - `data` object — Integration-specific configuration. For webhooks, contains webhook_url.

## Other responses

- `403` — Forbidden – insufficient permissions
- `404` — Form or integration not found
- `422` — Validation error

---

[API](https://skmtc.dev/opnform/apis/opnform-api.md) · [All operations](https://skmtc.dev/opnform/apis/opnform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/opnform/opnform-api/revisions/271b61a0082b/schema)