---
title: "POST /api/fundraise/campaigns"
method: POST
path: "/api/fundraise/campaigns"
tags: ["api", "fundraise"]
---

# POST /api/fundraise/campaigns

`POST /api/fundraise/campaigns`

Create a Campaign

## Request body

- object
  - `name` string, required — The name of the campaign
  - `target` object — The target (goal) amount and date of the campaign
    - `amount` number — The target amount of the campaign
    - `date` string, date-time — An ISO timestamp indicating when the campaign is planned to reach the goal (amount).
  - `externalId` string — The external ID of the campaign

## Response `201`

Created

- CampaignResource
  - `_id` string, required — The ID of the marketing campaign
  - `name` string, required — The name of the marketing campaign
  - `code` string, required — The code of the marketing campaign
  - `createdBy` object, required — The entity that created this marketing campaign
    - `type` 'USER' | 'APP' | 'API_KEY' | 'SYSTEM', required — The type of the entity
    - `id` string, required — The ID of the entity
  - `sellerId` string, required — The ID of the seller owning the marketing campaign
  - `isArchived` boolean, required — Whether the marketing campaign is archived or not.
  - `createdAt` string, date-time, required — An ISO timestamp indicating when the marketing campaign was created.
  - `updatedAt` string, date-time, required — An ISO timestamp indicating when the marketing campaign was updated.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

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