## Documentation Index

Fetch the complete documentation index at: [/docs/llms.txt](/content/docs/llms.txt)

Use this file to discover all available pages before exploring further.

PATCH

[https://api.polar.sh/v1/webhooks/endpoints/{id}](https://api.polar.sh/v1/webhooks/endpoints/{id})

### Try it

#### Python

```python
from polar.v2026_04 import Polar

polar = Polar("polar_oat_xxx")

response = polar.webhooks.update_webhook_endpoint(
    '00000000-0000-4000-8000-000000000000',
)
print(response)
```

#### JavaScript

```javascript
import { createPolar } from "@polar-sh/sdk/2026-04";

const polar = createPolar({
  accessToken: "polar_oat_xxx",
});

const response = await polar.webhooks.updateWebhookEndpoint(
  "00000000-0000-4000-8000-000000000000",
  {},
);
console.log(response);
```

#### Curl

```bash
curl --request PATCH \
  --url https://api.polar.sh/v1/webhooks/endpoints/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://webhook.site/cb791d80-f26e-4f8c-be88-6e56054192b0",
  "name": "<string>",
  "events": [],
  "enabled": true
}
'```

#### Fetch API

```javascript
const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    url: 'https://webhook.site/cb791d80-f26e-4f8c-be88-6e56054192b0',
    name: '<string>',
    events: [],
    enabled: true
  })
};

fetch('https://api.polar.sh/v1/webhooks/endpoints/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

#### PHP

```php
<?php
$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.polar.sh/v1/webhooks/endpoints/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'url' => 'https://webhook.site/cb791d80-f26e-4f8c-be88-6e56054192b0',
    'name' => '<string>',
    'events' => [],
    'enabled' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error ": . $err;
} else {
  echo $response;
}
?>
```

#### Go

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

url := "https://api.polar.sh/v1/webhooks/endpoints/{id}"

payload := strings.NewReader("{\n  \"url\": \"https://webhook.site/cb791d80-f26e-4f8c-be88-6e56054192b0\",\n  \"name\": \"<string>\",\n  \"events\": [],\n  \"enabled\": true\n}")

req, _ := http.NewRequest("PATCH", url, payload)

req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

fmt.Println(string(body))
}
```

### Response

#### Success - 200

```json
{
  "created_at": "2026-01-01T00:00:00.000000Z",
  "modified_at": "2026-01-01T00:00:00.000000Z",
  "id": "<string>",
  "url": "https://webhook.site/cb791d80-f26e-4f8c-be88-6e56054192b0",
  "api_version": "<string>",
  "format": "raw",
  "secret": "whsec_ovyN6cPrTv56AApvzCaJno08SSmGJmgbWilb33N2JuK",
  "organization_id": "<string>",
  "events": [
    "checkout.created"
  ],
  "enabled": true,
  "uses_standard_webhook_signature": true,
  "name": "<string>"
}
```

#### Error - 404

```json
{
  "error": "ResourceNotFound",
  "detail": "<string>"
}
```

#### Validation Error - 422

```json
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}
```

### Authorizations

- **Authorization**: string (header)

You can generate a Personal Access Token from your [settings](/content/settings/index.html).

### Path Parameters

- **id**: string<uuid4> (required)  The webhook endpoint ID.

### Body

- **url**: string<uri> | null (required)  The URL where the webhook events will be sent.

Example:
`"https://webhook.site/cb791d80-f26e-4f8c-be88-6e56054192b0"`

- **name**: string | null (optional)  An optional name for the webhook endpoint to help organize and identify it.

- **api_version**: enum<string> | null (required)  The API version that'll be used in event payloads.

Available options: `2026-04`, `2026-10`

- **format**: enum<string> | null (required)  The format of the webhook payload.

Available options: `raw`, `discord`, `slack`

- **events**: enum<string>[] | null (required)  The events that will trigger the webhook.