---
title: "Update subscription secret"
method: PUT
path: "/webhooks-api/v2/accounts/{accountUid}/subscriptions/{subscriptionUid}/secret"
tags: ["Webhooks"]
---

# Update subscription secret

`PUT /webhooks-api/v2/accounts/{accountUid}/subscriptions/{subscriptionUid}/secret`

## Request

- Base URL: `https://api.smartling.com`
- URL: `https://api.smartling.com/webhooks-api/v2/accounts/{accountUid}/subscriptions/{subscriptionUid}/secret`
- Auth: HTTP bearer

Update the secret key used for webhook signature verification.

## Path parameters

- `accountUid` string, required
- `subscriptionUid` string, required

## Request body

- UpdateSubscriptionSecretCommand
  - `payloadSecret` string: Secret used to sign webhook deliveries.

## Response `200`

Success

## Other responses

- `400`: Provided request parameters are invalid.
- `401`: Authentication failed.
- `404`: Resource not found.
- `429`: Rate limit exceeded.
- `500`: Internal server error.

## Changes

- **2026-10-17** `2cd7a8215799`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/changes/webhooks-api/v2/accounts/:accountUid/subscriptions/:subscriptionUid/secret/put.md)

---

[API](https://skmtc.dev/smartling/apis/smartling-rest-api-reference.md) - [All operations](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/revisions/e63066e7f5e9?raw)