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

# Create campaign

`POST /campaigns`

## Request body

- Campaign — Represents an outreach campaign that targets a specific resource, such as a patient, facility, or user, and defines which contact channels like SMS, email, or voice should be attempted and in what order. It tracks whether the campaign is active, who last updated it, and optional external identifiers for syncing with third-party systems, and is used to drive automated patient engagement workflows like recall or referral outreach.
  - `_id` string — Luma's internal ID of an object.
  - `user` string — The ID of the root account user.
  - `deleted` 0 | 1 — Flag for logical deletion where 1 means deleted.
  - `createdBy` string — The ID of the user who created this object.
  - `updatedBy` string — The ID of the user who updated this object.
  - `createdAt` string, date-time — The date/time when this object was created.
  - `updatedAt` string, date-time — The date/time when this object was updated.
  - `ref` 'patient' | 'facility' | 'user'
  - `refId` string
  - `name` string
  - `channels` string[]
  - `type` 'inbound' | 'outbound'
  - `lastUpdatedBy` 'patient' | 'integrator'
  - `active` unknown

## Response `201`

Successful creation

- Campaign — Represents an outreach campaign that targets a specific resource, such as a patient, facility, or user, and defines which contact channels like SMS, email, or voice should be attempted and in what order. It tracks whether the campaign is active, who last updated it, and optional external identifiers for syncing with third-party systems, and is used to drive automated patient engagement workflows like recall or referral outreach.
  - `_id` string — Luma's internal ID of an object.
  - `user` string — The ID of the root account user.
  - `deleted` 0 | 1 — Flag for logical deletion where 1 means deleted.
  - `createdBy` string — The ID of the user who created this object.
  - `updatedBy` string — The ID of the user who updated this object.
  - `createdAt` string, date-time — The date/time when this object was created.
  - `updatedAt` string, date-time — The date/time when this object was updated.
  - `ref` 'patient' | 'facility' | 'user'
  - `refId` string
  - `name` string
  - `channels` string[]
  - `type` 'inbound' | 'outbound'
  - `lastUpdatedBy` 'patient' | 'integrator'
  - `active` unknown

## Other responses

- `401` — Not authenticated
- `403` — Access token does not have the required scope
- `default` — Unexpected error

---

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