---
title: "Update webhook subscription"
url: "https://docs.unified.to/unified/webhook/Update_webhook_subscription"
description: "API reference for Update webhook subscription. Launch multiple pre-built Webhook integrations today with zero maintenance — all through a single API."
generated_at: "2026-05-21T18:16:16.427Z"
---
# Update webhook subscription

 PUT/unified/webhook/{id}

## Parameters

**id**string  required 

ID of the Webhook

## Payload

A webhook is used to POST new/updated information to your server.

**id**string  read-only 

**created\_at**date  read-only 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**updated\_at**date  read-only 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**workspace\_id**string  read-only 

(reference to KmsSpace)

**connection\_id**string  required 

**hook\_url**string 

The URL of the webhook

**object\_type** enum required 

Valid values:

 "accounting\_account" 

 "accounting\_transaction" 

 "accounting\_journal" 

 "accounting\_contact" 

 "accounting\_invoice" 

The object to return (eg. CRM "contact")

**interval**number 

The interval (in minutes) to check for updated/new objets. 

**checked\_at**date  read-only 

The last date/time that a check was done on this object (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**integration\_type**string  read-only 

**environment**string  read-only 

**event** enum required 

Valid values:

 "updated" 

 "created" 

 "deleted" 

**runs**string array  read-only 

An array of the most revent virtual webhook runs

**fields**string 

**webhook\_type** enum

Valid values:

 "virtual" 

 "native" 

**meta**any  read-only 

**is\_healthy**boolean  read-only 

**page\_max\_limit**number 

**filters**string dictionary of string 

**db\_type** enum

Valid values:

 "mongodb" 

 "mysql" 

 "postgres" 

 "mssql" 

 "mariadb" 

**db\_url**string 

**db\_schema**string 

**db\_name\_prefix**string 

**is\_paused**boolean 

**is\_beta**boolean 

## Returns

[Webhook](/unified/webhook/model)

A webhook is used to POST new/updated information to your server.

**id**string  read-only 

**created\_at**date  read-only 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**updated\_at**date  read-only 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**workspace\_id**string  read-only 

(reference to KmsSpace)

**connection\_id**string  required 

**hook\_url**string 

The URL of the webhook

**object\_type** enum required 

Valid values:

 "accounting\_account" 

 "accounting\_transaction" 

 "accounting\_journal" 

 "accounting\_contact" 

 "accounting\_invoice" 

The object to return (eg. CRM "contact")

**interval**number 

The interval (in minutes) to check for updated/new objets. 

**checked\_at**date  read-only 

The last date/time that a check was done on this object (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**integration\_type**string  read-only 

**environment**string  read-only 

**event** enum required 

Valid values:

 "updated" 

 "created" 

 "deleted" 

**runs**string array  read-only 

An array of the most revent virtual webhook runs

**fields**string 

**webhook\_type** enum

Valid values:

 "virtual" 

 "native" 

**meta**any  read-only 

**is\_healthy**boolean  read-only 

**page\_max\_limit**number 

**filters**string dictionary of string 

**db\_type** enum

Valid values:

 "mongodb" 

 "mysql" 

 "postgres" 

 "mssql" 

 "mariadb" 

**db\_url**string 

**db\_schema**string 

**db\_name\_prefix**string 

**is\_paused**boolean 

**is\_beta**boolean 

## Code Samples

### Node.js SDK

```
import { UnifiedTo } from '@unified-api/typescript-sdk';

const sdk = new UnifiedTo({
    security: {
        jwt: '<YOUR_API_KEY_HERE>',
    },
});

const id = '1234';

const results = await sdk.unified.updateUnifiedWebhook({ id: '5dc201f9414446e39b2045aa', 

 });
```

### Node.js (axios)

```
const options = {
  method: 'PUT',
  url: 'https://api.unified.to/unified/webhook/5de520f96e439b002043d8d8',
  headers: {
    authorization: 'bearer .....'
  },
  data: undefined,

};

const results = await axios.request(options);
```

### Java

```
AsyncHttpClient client = new DefaultAsyncHttpClient();

client.prepare("PUT", "https://api.unified.to/unified/webhook/5de520f96e439b002043d8d8")
  .setHeader("accept", "application/json")
  .setHeader("authorization", ".....")
  .execute()
  .toCompletableFuture()
  .thenAccept(System.out::println)
  .join();

client.close();
```

### Go

```
import (
	"fmt"
	"net/http"
	"io/ioutil"
)

url := `https://api.unified.to/unified/webhook/5de520f96e439b002043d8d8

req, _ := http.NewRequest("PUT", url, nil)

req.Header.Add("accept", "application/json")
req.Header.Add("authorization", ".....")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
```

### Python

```
import requests

url = "https://api.unified.to/unified/webhook/5de520f96e439b002043d8d8"

headers = {
    "accept": "application/json",
    "authorization": "....."
}

response = requests.put(url, headers=headers)
```

### PHP

```
$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.unified.to/unified/webhook/5de520f96e439b002043d8d8",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_HTTPHEADER => [
    "accept: application/json",
    "authorization: ....."
  ],
]);
```

### Ruby

```
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.unified.to/unified/webhook/5de520f96e439b002043d8d8")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["accept"] = 'application/json'
request["authorization"] = '....'

response = http.request(request)
puts response.read_body
```

### cURL

```
curl --request PUT \
  --url 'https://api.unified.to/unified/webhook/5de520f96e439b002043d8d8' \
  --header 'accept: application/json' \
  --header 'authorization: .....'
```