---
title: "PUT /v4/campaign-lists/{owner}/{name}"
method: PUT
path: "/v4/campaign-lists/{owner}/{name}"
tags: ["Campaign Lists"]
---

# PUT /v4/campaign-lists/{owner}/{name}

`PUT /v4/campaign-lists/{owner}/{name}`

Replace the campaign IDs in a named list (an empty array deletes the list). Requires the owner's JWT or API key.

## Path parameters

- `owner` string, required — List owner address (validated and checksum-normalized)
- `name` string, required — List name (case-insensitive)

## Request body

- object
  - `campaignIds` union[], required — Campaign IDs to include in the list. Each entry is either an internal hash (`Campaign.id`) or a `{ distributionChain, campaignId }` composite.
    - union
      - string — Internal campaign ID (hash string)
      - object — Composite identifier `{ distributionChain, campaignId }`
        - `distributionChain` number, required — Distribution chain ID
        - `campaignId` string, required — Onchain campaign ID

## Response `200`

Response for status 200

- object
  - `owner` string, required
  - `name` string, required
  - `campaignIds` string[], required
  - `size` number, required

---

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