---
title: "Rotate sequence inbound webhook secret"
method: POST
path: "/sequences/{sequenceId}/inbound-webhook/rotate-secret"
tags: ["Sequences"]
---

# Rotate sequence inbound webhook secret

`POST /sequences/{sequenceId}/inbound-webhook/rotate-secret`

Immediately invalidates the previous URL and returns the replacement endpoint.

## Path parameters

- `sequenceId` string, required

## Response `200`

Secret rotated successfully

- object
  - `success` boolean
  - `webhook` SequenceInboundWebhook
    - `id` string
    - `secret` string — Secret URL token. Treat it as a credential.
    - `url` string, uri
    - `eventName` string
    - `fieldMapping` SequenceInboundWebhookFieldMapping
      - `email` string, required — Dot path to the subscriber email in the webhook payload.
      - `firstName` string
      - `lastName` string
      - `properties` object
    - `samplePayload` object, nullable
    - `sampleCapturedAt` string, date-time, nullable
    - `status` 'pending_setup' | 'active'
    - `createdAt` string, date-time

## Other responses

- `400` — Sequence is not configured with a valid inbound_webhook trigger
- `404` — Sequence inbound webhook not found

## Changes

- **2026-08-19** `ba3a29c6eb33` — 2 info
  - added the optional property `retryable` to the response with the `400` status
  - added the optional property `retryable` to the response with the `404` status
- **2026-08-16** `6fd2903b91ce` — 2 info
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `404` status
- **2026-08-02** `36f92fc0caa2` — 2 breaking
  - the response property `success` became optional for the status `400`
  - the response property `success` became optional for the status `404`
- **2026-07-18** `09f0c32988fb` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/sequences/:sequenceId/inbound-webhook/rotate-secret/post.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/revisions/73f826277d9a/schema)