---
title: "Create Campaign"
method: POST
path: "/v1/campaigns"
tags: ["Campaigns"]
---

# Create Campaign

`POST /v1/campaigns`

## Request body

- CampaignPostRequestDto
  - `data` object, required
    - `channel` 'SMS' | 'VIBER' | 'WHATSAPP', required — Channel of the campaign. Enumeration values [SMS, VIBER, WHATSAPP]
    - `name` string — Unique name of the campaign
    - `from` string, required — Name (unique identifier) of the sender
    - `audience` string, uuid, required — Identifier of the audience
    - `template` string, uuid, required — Identifier of the template
    - `schedule` string, date-time — Campaigns without schedule date are sent immediately. Optionally they can be scheduled, and schedule date should be after current date in UTC, formatted as yyyy-mm-dd hh:mm:ss

## Response `201`

Created

- 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 1504 Invalid message sender 1505 Message sender is not found 1512 Invalid template id 1513 Template is not found 1522 Schedule date should be after current date 1603 'data.from' is required 1605 'data.audience' is required 1607 'data.template' is required 1609 'data.schedule' is invalid 1615 Invalid audience id 1616 Audience is not found 1616 Template ID does not exist for this channel 1617 Audience ID does not exist for this channel 1631 'data.name' is invalid \* Channel is required
- `409` — **Conflict:** Code Message 1614 Campaign exist

---

[API](https://skmtc.net/dexatel/apis/verify-apis.md) · [All operations](https://skmtc.net/dexatel/apis/verify-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dexatel/verify-apis/revisions/a924257f431d/schema)