---
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

---

[API](https://skmtc.net/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.net/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/versions/af1cf9620482/schema)