---
title: "Create a new campaign record entry"
method: POST
path: "/campaign"
tags: ["campaign"]
---

# Create a new campaign record entry

`POST /campaign`

Creates one or more new campaign records. Campaigns organize call tracking by marketing initiative, allowing you to track performance across different advertising channels and sources.

## Request body

- CampaignPost[]
  - `campaign_id` integer — Unique identifier representing the campaign
  - `campaign_name` string, required — Client defined name for the campaign
  - `campaign_ext_id` string — A client provided identifier for the campaign
  - `campaign_status` 'active' | 'inactive' — The current status of the campaign
  - `campaign_created` string, date-time — The date and time of when the campaign record was created
  - `campaign_modified` string, date-time — A date and time stamp of the last time anything was modified on campaign
  - `campaign_start_date` string, date-time, required — The date and time that the campaign is activated
  - `campaign_end_date` string — The date and time at which the campaign will end or use 'never' for no end date
  - `campaign_owner_user_id` integer, required — The unique ID of the user that is the owner of the campaign
  - `group_id` integer, required — The unique group to which the campaign belongs to
  - `referral_service` object — Referral Service
    - `referral_enabled` boolean, required — This enables/disables referral service
    - `ringto_phone_number` integer — Phone number in referral recording if campaign is in referral state
  - `campaign_users` integer[]

## Response `200`

Newly created campaign IDs and confirmation status for each campaign

- StandardPostResponse[]
  - `result` string, required — Outcome of the request. String, typically 'success' or 'error'.
  - `data` string, required — Response payload. Shape varies by endpoint.
  - `entry_count` integer, required — The sequential number of the entry in the submitted array. Type: integer (int32).

## Other responses

- `default` — Unexpected error

---

[API](https://skmtc.net/convirza/apis/convirza-apis.md) · [All operations](https://skmtc.net/convirza/apis/convirza-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/convirza/convirza-apis/versions/ccf9bbe34f5a/schema)