Skip to main content
POST
Create a campaign

Authorizations

Authorization
string
header
required

A Dueflow access token: dfp_ (personal) or dfs_ (service). Permissions are the token's scopes intersected with the role ceiling, re-evaluated per request.

Scopes

fundraise:write

Headers

Idempotency-Key
string
required

A unique key per logical operation, e.g. a UUID. Keys are remembered for 24 hours per token: a retry within that window with the same key replays the original response (marked Idempotent-Replayed: true) instead of repeating the write; reusing a key with different parameters is a 409.

Maximum string length: 255

Body

application/json
name
string
required
Required string length: 1 - 120
goalAmount
string
required
Pattern: ^\d+(\.\d{1,2})?$
startDate
string<date>
required
status
enum<string>
required
Available options:
draft,
active,
ended
note
string | null
Maximum string length: 5000
endDate
string<date> | null
currency
enum<string>
Available options:
usd,
cad,
gbp,
eur

Response

Success

id
string
required
name
string
required
note
string | null
required
goalAmount
string
required
currency
string
required
startDate
string
required
endDate
string | null
required
status
enum<string>
required
Available options:
draft,
active,
ended
createdAt
string<date-time>
required

Timestamp: RFC 3339, UTC, millisecond precision (2026-01-31T17:04:05.123Z).

updatedAt
string<date-time>
required

Timestamp: RFC 3339, UTC, millisecond precision (2026-01-31T17:04:05.123Z).