---
title: "Edit campaign"
method: PUT
path: "/v1/campaigns/{id}"
tags: ["Campaigns"]
---

# Edit campaign

`PUT /v1/campaigns/{id}`

## Request

- Base URL: `https://api.dexatel.com`
- URL: `https://api.dexatel.com/v1/campaigns/{id}`
- Auth: API key in header `X-Dexatel-Key`

## Request body

- CampaignPutRequestDto
  - `data` object, required
    - `schedule` string, date-time: Update campaigns with 'scheduled' status. Updated scheduled date should be after current date in UTC, formatted as yyyy-mm-dd hh:mm:ss
    - `status` 'CANCELED': Cancel campaigns with 'scheduled' or 'in_progress' status. If campaign is 'in_progress' status, already sent messages will not be canceled

## Response `200`

OK

- CampaignPostResponseWrapperDto
  - `data` object
    - `user_id` string: Unique identifier of the user who initiated the campaign
    - `id` string, uuid: Unique identifier of the campaign
    - `sender` string: Name (unique identifier) of the sender
    - `account_id` string, uuid: Unique identifier of the account
    - `template_id` string, uuid: Unique identifier of the template
    - `audience_id` string, uuid: Unique identifier of the audience
    - `name` string: Unique name of the campaign
    - `status` 'in_progress' | 'completed' | 'scheduled' | 'canceled': Status of the campaign. Enumeration values [in_progress, completed, scheduled, canceled]
    - `channel` 'SMS' | 'VIBER' | 'WHATSAPP': Channel of the campaign. Enumeration values [SMS, VIBER, WHATSAPP]
    - `schedule` string, date-time: Schedule date of the campaign in UTC, formatted as yyyy-mm-dd hh:mm:ss
    - `create_date` string, date-time: Creation date of the campaign in UTC, formatted as yyyy-mm-dd hh:mm:ss
    - `update_date` string, date-time: Update date of the campaign in UTC, formatted as yyyy-mm-dd hh:mm:ss
    - `links` object
      - `self` string: URL of the requested resource
      - `account` string: URL of the account
      - `template` string: URL of the template
      - `audience` string: URL of the audience

## Other responses

- `400`: **Bad Request:** Code Message Description 1522 Schedule date should be after current date 1619 Already canceled campaign 1630 Updating scheduled date is only allowed for Scheduled campaigns \* Can't edit campaign in \* status
- `404`: **Not Found:** Code Message 1601 Campaign is not found

---

[API](https://skmtc.dev/dexatel/apis/contacts-and-messaging.md) - [All operations](https://skmtc.dev/dexatel/apis/contacts-and-messaging/llms.txt) - [OpenAPI document](https://skmtc.dev/dexatel/apis/contacts-and-messaging/revisions/f07e4f03a129?raw)