Skip to main content
PUT
/
open
/
forms
/
{form}
/
integrations
/
{integrationid}
curl -X PUT 'https://api.opnform.com/open/forms/123/integrations/42' \
  -H 'Authorization: Bearer YOUR_PAT' \
  -H 'Content-Type: application/json' \
  -d '{
    "integration_id": "webhook",
    "status": "active",
    "data": {
      "webhook_url": "https://new-endpoint.com/opnform-hook"
    }
  }'

{
  "message": "Form Integration was updated.",
  "form_integration": {
    "id": 42,
    "form_id": 123,
    "integration_id": "webhook",
    "status": "active",
    "data": {
      "webhook_url": "https://new-endpoint.com/opnform-hook"
    }
  }
}

​
Update Webhook Integration

Modify an existing webhook integration’s URL or status.

​
Authentication & Scope

This endpoint requires a Personal Access Token with the manage-integrations ability.

​
Request

​
form
number
required
The ID of the form containing the webhook.
​
integrationid
number
required
The ID of the webhook integration to update.
​
integration_id
string
required
Must be set to "webhook".
​
status
string
The status of the webhook. Allowed values: "active", "inactive".
​
data
object
required
Configuration object containing webhook details.
curl -X PUT 'https://api.opnform.com/open/forms/123/integrations/42' \
  -H 'Authorization: Bearer YOUR_PAT' \
  -H 'Content-Type: application/json' \
  -d '{
    "integration_id": "webhook",
    "status": "active",
    "data": {
      "webhook_url": "https://new-endpoint.com/opnform-hook"
    }
  }'

​
Response

200 OK – Webhook updated successfully. 
{
  "message": "Form Integration was updated.",
  "form_integration": {
    "id": 42,
    "form_id": 123,
    "integration_id": "webhook",
    "status": "active",
    "data": {
      "webhook_url": "https://new-endpoint.com/opnform-hook"
    }
  }
}
403 Forbidden – The token does not have manage-integrations ability or insufficient form permissions. 404 Not Found – Form or integration not found. 422 Unprocessable Entity – Validation error. 
{
  "message": "The webhook url must be a valid URL.",
  "errors": {
    "data.webhook_url": ["The webhook url must be a valid URL."]
  }
}

Authorizations

​
Authorization
string
header
required

Personal Access Token

Path Parameters

​
form
number
required

The ID of the form.

​
integrationid
number
required

The ID of the integration.

Body

application/json
​
integration_id
enum<string>
required

Must be "webhook"

Available options:
webhook
​
data
object
required
​
status
enum<string>

The status of the webhook

Available options:
active,
inactive

Response

Webhook updated successfully

​
message
string
Example:

"Form Integration was updated."

​
form_integration
object