---
title: "Create or replace the account webhook"
method: PUT
path: "/v1/webhooks"
tags: ["Webhooks"]
---

# Create or replace the account webhook

`PUT /v1/webhooks`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/webhooks`
- Auth: HTTP bearer

One webhook per account. Use public HTTPS. Omitted secret generates one. Save the PUT response securely.

## Request body

- object
  - `url` string, uri, required
  - `secret` string

## Response `200`

Success

- object
  - `url` string
  - `secret` string
  - `enabled` boolean

## Other responses

- `default`: Error. The JSON error and message fields are stable. Additional fields may provide details. Authentication, rate limits, and transient failures apply to all operations.

---

[API](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api.md) - [All operations](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/revisions/a59210899d95?raw)