---
title: "Rotate campaign webhook subscription secret"
method: POST
path: "/campaigns/webhooks/subscriptions/{subscription_id}/rotate-secret"
tags: ["Campaign Webhooks"]
---

# Rotate campaign webhook subscription secret

`POST /campaigns/webhooks/subscriptions/{subscription_id}/rotate-secret`

## Request

- Base URL: `https://public.outreach2day.com`
- URL: `https://public.outreach2day.com/campaigns/webhooks/subscriptions/{subscription_id}/rotate-secret`
- Auth: HTTP bearer

Replace the signing secret used to generate webhook signature headers.

## Path parameters

- `subscription_id` integer, required

## Query parameters

- `workspaceId` integer, required

## Request body

- BodyPublicRotateCampaignWebhookSubscriptionSecretCampaignsWebhooksSubscriptionsSubscriptionIdRotateSecretPost
  - `secret` string, nullable

## Response `200`

Successful Response

- CampaignWebhookSubscriptionEnvelopeOut
  - `subscription` CampaignWebhookSubscriptionOut
    - `id` integer, nullable
    - `workspace_id` integer, nullable
    - `name` string, nullable
    - `endpoint` string, nullable
    - `status` string, nullable
    - `event_types` string[]
    - `reply_intents` string[]
    - `campaign_ids` string[]
    - `ignore_ooo` boolean, nullable
    - `ignore_auto_reply` boolean, nullable
    - `min_confidence` number, nullable
    - `headers` object
    - `secret_last4` string, nullable
    - `created_by_user_id` integer, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
    - `deleted_at` string, date-time, nullable
    - `last_tested_at` string, date-time, nullable
    - `last_error` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/outreach2day/apis/outreach-today-public-api.md) · [All operations](https://skmtc.dev/outreach2day/apis/outreach-today-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/outreach2day/apis/outreach-today-public-api/revisions/0e5471143371?raw)