---
title: "Update a draft campaign"
method: PUT
path: "/campaigns/{campaignId}"
tags: ["Campaigns"]
---

# Update a draft campaign

`PUT /campaigns/{campaignId}`

Update a draft campaign's name, labels, content, From/Reply-To settings, or campaign personalization data. Direct addresses create profiles when needed.

## Path parameters

- `campaignId` string, required

## Request body

- object
  - `name` string — Updated campaign name
  - `subject` string — Updated email subject line
  - `previewText` string, nullable — Updated inbox preview text. Set to null to clear it.
  - `preheaderText` string, nullable — Compatibility alias for previewText.
  - `trackingCode` string, nullable — Campaign tracking code available to UTM templates as `{{campaign.trackingCode}}`. Send an empty string or null to clear it.
  - `html` string — Updated email HTML content. Mutually exclusive with `blocks`.
  - `blocks` object[] — Updated Sequenzy email blocks. Mutually exclusive with `html`. Put visual styling under styles; top-level style keys such as backgroundColor, backgroundOpacity, borderColor, borderWidth, and borderRadius are normalized into styles.
  - `fromEmail` string, email — Campaign From address. Its domain must be configured and verified.
  - `fromName` string — Display name for a newly created sender profile. Requires fromEmail.
  - `senderProfileId` string — Existing sender profile ID. Mutually exclusive with fromEmail.
  - `replyTo` string, email — Reply-To email for this campaign. A profile is created when needed. Mutually exclusive with `replyProfileId`.
  - `replyProfileId` string — Reply profile ID for this company. Mutually exclusive with `replyTo`.
  - `replyToName` string — Display name for a newly created reply profile. Requires replyTo.
  - `ccEmails` string[], nullable — Addresses CC'd on every recipient's email for this campaign. Send an empty array or null to clear them.
  - `bccEmails` string[], nullable — Addresses BCC'd on every recipient's email for this campaign. Send an empty array or null to clear them.
  - `labels` string[] — Replacement label names. Send an empty array to clear labels. Missing labels are created automatically.
  - `label` string[] — Compatibility alias for labels.
  - `campaignData` object, nullable — Campaign-scoped JSON data available while rendering this campaign. Top-level arrays can contain up to 500 items. Set to null to clear it.
  - `computedLists` object[] — Personalized list definitions computed from campaignData. Keys can use letters, numbers, underscores, and dots. Use maxItems to cap each subscriber's list length. Pass an empty array to clear computed lists.

## Response `200`

Campaign updated successfully

- object
  - `success` boolean, required
  - `campaign` object, required
    - `id` string
    - `name` string
    - `subject` string
    - `status` string
    - `labels` string[]
    - `replyProfileId` string, nullable
    - `replyToName` string, nullable
    - `replyToEmail` string, email, nullable
    - `ccEmails` string[], nullable
    - `bccEmails` string[], nullable
    - `url` string, uri
    - `previewUrl` string, uri

## Other responses

- `400` — Validation error
- `401` — Unauthorized
- `404` — Campaign not found
- `422` — Request body failed schema validation

## Changes

- **2026-07-16** `d7ea66dede72` — 4 info
  - added the new optional request property `bccEmails`
  - added the new optional request property `ccEmails`
  - added the optional property `campaign/bccEmails` to the response with the `200` status
  - added the optional property `campaign/ccEmails` to the response with the `200` status
- **2026-07-12** `d103f2b71fca` — 4 info
  - added the new optional request property `fromEmail`
  - added the new optional request property `fromName`
  - added the new optional request property `replyToName`
  - added the new optional request property `senderProfileId`
- **2026-07-02** `f4df432f0a85` — 2 info
  - added the new optional request property `preheaderText`
  - added the new optional request property `previewText`
- **2026-05-19** `1a51a400be50` — 1 info
  - added the new optional request property `trackingCode`
- **2026-05-15** `b040bb8c6608` — 2 info
  - added the optional property `campaign/previewUrl` to the response with the `200` status
  - added the optional property `campaign/url` to the response with the `200` status

[Full history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/campaigns/:campaignId/put.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/d7ea66dede72/schema)