---
title: "Dashboard alias: create or replace the account webhook with the session cookie"
method: PUT
path: "/v1/account"
tags: ["Account"]
---

# Dashboard alias: create or replace the account webhook with the session cookie

`PUT /v1/account`

## Request

- Base URL: `https://api.scripthaul.com`
- URL: `https://api.scripthaul.com/v1/account`
- Auth: HTTP bearer

Same behaviour as PUT /v1/webhooks, reachable with the dashboard session cookie plus the X-ScriptHaul-Dashboard: 1 header. The resource parameter selects the operation; the only value today is webhook.

## Query parameters

- `resource` 'webhook', required

## Request body

- WebhookConfig
  - `url` string, uri, required
  - `low_balance_threshold` integer, nullable
  - `rotate_secret` boolean: Issue a new signing secret and return it once in this response.

## Response `200`

Webhook configured; webhook_secret is present only when a new secret was issued

## Other responses

- `400`: Typed API error
- `401`: Typed API error
- `403`: Typed API error

---

[API](https://skmtc.dev/scripthaul/apis/scripthaul-api.md) · [All operations](https://skmtc.dev/scripthaul/apis/scripthaul-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scripthaul/apis/scripthaul-api/revisions/f476d69f4a6b?raw)