---
title: "Update 10DLC campaign"
method: PATCH
path: "/v1/10dlc/campaigns/{campaignId}"
tags: ["10DLC"]
---

# Update 10DLC campaign

`PATCH /v1/10dlc/campaigns/{campaignId}`

## Request

- Base URL: `https://api.zavu.dev`
- URL: `https://api.zavu.dev/v1/10dlc/campaigns/{campaignId}`
- Auth: HTTP bearer

Update a 10DLC campaign in draft status. Cannot update after submission.

## Path parameters

- `campaignId` string, required

## Request body

- TenDlcCampaignUpdateRequest
  - `name` string
  - `description` string
  - `sampleMessages` string[]
  - `messageFlow` string
  - `helpMessage` string
  - `optInKeywords` string[]
  - `optOutKeywords` string[]

## Response `200`

Campaign updated.

- TenDlcCampaignResponse
  - `campaign` TenDlcCampaign, required
    - `id` string, required
    - `brandId` string, required: ID of the brand this campaign belongs to.
    - `name` string, required
    - `useCase` string, required: Campaign use case type.
    - `subUseCases` string[], nullable
    - `description` string, required: Description of the messaging campaign.
    - `sampleMessages` string[], required: Sample messages representative of campaign content.
    - `subscriberOptIn` boolean, required
    - `subscriberOptOut` boolean, required
    - `subscriberHelp` boolean, required
    - `numberPooling` boolean, required
    - `directLending` boolean, required
    - `embeddedLink` boolean, required
    - `embeddedPhone` boolean, required
    - `affiliateMarketing` boolean, required
    - `ageGated` boolean, required
    - `messageFlow` string, nullable
    - `helpMessage` string, nullable
    - `optInKeywords` string[], nullable
    - `optOutKeywords` string[], nullable
    - `status` 'draft' | 'pending' | 'approved' | 'rejected' | 'expired' | 'failed', required: Status of a 10DLC campaign registration. - `draft`: created, not yet submitted. - `pending`: submitted, awaiting the carriers. Re-read from the carrier every 30 minutes, so it moves on its own. - `approved`: SMS to +1 numbers can go out from numbers assigned to it. The monthly fee is charged while it is approved. - `rejected`: refused by the carriers. The one-time registration fee is refunded. - `failed`: the registration did not reach the carriers. The fee is refunded. - `expired`: was approved and has lapsed.
    - `dailyLimit` integer, nullable: Daily message limit based on brand trust score.
    - `failureReason` string, nullable
    - `registrationCostCents` integer, nullable: One-time registration cost in cents.
    - `monthlyFeeCents` integer, nullable: Recurring monthly fee in cents.
    - `submittedAt` string, date-time, nullable
    - `approvedAt` string, date-time, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Other responses

- `400`: Invalid request or campaign already submitted.
- `401`: Unauthorized.
- `404`: Campaign not found.

## Changes

> 80 revisions in range; 1 not diffed.

- **2026-10-19** `70b974d2650a`: 2 warning
  - added the new `expired` enum value to the `campaign/status` response property for the response status `200`
  - added the new `failed` enum value to the `campaign/status` response property for the response status `200`
- **2026-03-17** `dca8af164271`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zavudev/apis/zavu-unified-messaging-layer-api/changes/v1/10dlc/campaigns/:campaignId/patch.md)

---

[API](https://skmtc.dev/zavudev/apis/zavu-unified-messaging-layer-api.md) - [All operations](https://skmtc.dev/zavudev/apis/zavu-unified-messaging-layer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zavudev/apis/zavu-unified-messaging-layer-api/revisions/75bc777b0ffb?raw)