---
title: "POST /campaign"
method: POST
path: "/campaign"
tags: ["campaign"]
---

# POST /campaign

`POST /campaign`

## Request

- Base URL: `https://www.weclapp.com/api/nullapi/v2`
- URL: `https://www.weclapp.com/api/nullapi/v2/campaign`
- Auth: API key in header `AuthenticationToken`
- TypeScript: <https://skmtc.dev/weclapp/apis/weclapp-api/docs/campaign/post.ts> (a function with typed inputs; its response is checked against the schema)

create a campaign

## Query parameters

- `dryRun` boolean

## Request body

- Campaign
  - `id` string
  - `version` string
  - `campaignEndDate` integer
  - `campaignName` string, required
  - `campaignNumber` string
  - `campaignStartDate` integer
  - `campaignType` 'ADVERTISEMENT' | 'BULKMAIL' | 'EMAIL' | 'EVENT' | 'EXPOSITION' | 'FAIR' | 'OTHER' | 'PUBLICRELATION' | 'TELEMARKETING' | 'WEBINAR'
  - `createdDate` integer
  - `customAttributes` CustomAttribute[]
    - `attributeDefinitionId` string
    - `booleanValue` boolean
    - `dateValue` integer
    - `entityId` string
    - `entityReferences` EntityReference[]
      - `entityId` string
      - `entityName` string
    - `numberValue` string, number
    - `selectedValueId` string
    - `selectedValues` OnlyId[]
      - `id` string
    - `stringValue` string
  - `description` string
  - `lastModifiedDate` integer
  - `responsibleUserId` string

## Response `201`

campaign create response

- Campaign
  - `id` string
  - `version` string
  - `campaignEndDate` integer
  - `campaignName` string, required
  - `campaignNumber` string
  - `campaignStartDate` integer
  - `campaignType` 'ADVERTISEMENT' | 'BULKMAIL' | 'EMAIL' | 'EVENT' | 'EXPOSITION' | 'FAIR' | 'OTHER' | 'PUBLICRELATION' | 'TELEMARKETING' | 'WEBINAR'
  - `createdDate` integer
  - `customAttributes` CustomAttribute[]
    - `attributeDefinitionId` string
    - `booleanValue` boolean
    - `dateValue` integer
    - `entityId` string
    - `entityReferences` EntityReference[]
      - `entityId` string
      - `entityName` string
    - `numberValue` string, number
    - `selectedValueId` string
    - `selectedValues` OnlyId[]
      - `id` string
    - `stringValue` string
  - `description` string
  - `lastModifiedDate` integer
  - `responsibleUserId` string

## Other responses

- `default`: error response

## Changes

- **2026-11-07** `0e021229755d`: 1 info
  - added the new optional `query` request parameter `dryRun`

[Operation history](https://skmtc.dev/weclapp/apis/weclapp-api/changes/campaign/post.md)

---

[API](https://skmtc.dev/weclapp/apis/weclapp-api.md) - [All operations](https://skmtc.dev/weclapp/apis/weclapp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/weclapp/apis/weclapp-api/revisions/0e021229755d?raw)