---
title: "Update a Fundraiser"
method: POST
path: "/v1/fundraisers/{id}"
tags: ["Fundraisers"]
---

# Update a Fundraiser

`POST /v1/fundraisers/{id}`

This request allows you to update the details of a Fundraiser.

You can make updates to:

* Enrich data.
* Modify parameter values.
* Remove parameter values.

The Fundraiser ID must belong to the account associated with the API key.

Fundraisers from subaccounts cannot be updated using the API key of the parent account. Attempting to do so will result in an error. To update a Fundraiser in a subaccount, you must use the API key of that subaccount.

For the update to succeed, the Fundraiser object must match the current campaign settings; otherwise, the operation will fail with a validation error.

Parallel requests to update the same object are not allowed and will result in an error.

Any parameters or child parameters that are not included will remain unchanged.

## Path parameters

- `id` string, required

## Request body

- UpdateFundraiserRequest — Contains the request parameters required for updating a Fundraiser.
  - `campaign` string — Campaign ID. Must belong to the account that owns the API key, otherwise an error will occur. The campaign must be active and accept money-based donations, otherwise an error will occur.
  - `code` string — Identifier of up to 150 characters. Does not need to be unique.
  - `description` string — Description of the Fundraiser
  - `designation` string — Designation ID.
  - `goal` GoalPostRequest — Goal for the Fundraiser.
    - `amount` string, required — Donation amount in the selected currency. Must be a decimal string in the format `{NNN}[.nn]`. Examples: 9.99 (for USD), 200 (for JPY). The amount must be greater than $10 or its equivalent in other currencies.
    - `end_date` string, required — Date when the goal ends. Must be in YYYY-MM-DD format and set to a future date.
  - `image` FundraiserImageRequest — Image of the Fundraiser.
    - `upload_url` string, required — The URL of the fundraiser's image. The image must be accessible with no authentication and validation.
  - `livemode` boolean — Specifies whether the request is executed in live or test mode. Required for API keys created after 30th January 2026. Fundraisers only exist in live mode — set this to `true`.
  - `name` string — The title of the Fundraiser, used as its main heading.
  - `slug` string — Unique identifier for the Fundraiser within the account or subaccount. The slug is not shared across accounts or subaccounts and must be unique within each. Can include up to 25 letters, numbers, underscores, or hyphens.
  - `status` 'active' | 'paused'

## Response `200`

On success, the API returns the Fundraiser object. If parameters are invalid, the call will return an error.

- GetFundraiserResponse — Represents a Fundraiser entry in the API.
  - `campaign` CampaignResponse, required — Provides details about the campaign.
    - `code` string, nullable, required — Campaign code, as set in the Dashboard.
    - `id` string, required — Unique campaign identifier.
    - `name` string, required — Campaign name.
  - `code` string, nullable, required — Code for the fundraiser, if applicable.
  - `created_at` string, required — Timestamp in ISO 8601 format, indicating when the fundraiser was created in UTC.
  - `currency` 'shp' | 'eur' | 'aed' | 'afn' | 'xcd' | 'all' | 'amd' | 'aoa' | 'ars' | 'usd' | 'aud' | 'ang' | 'xcg' | 'awg' | 'azn' | 'bam' | 'bbd' | 'inr' | 'pkr' | 'bdt' | 'xof' | 'bhd' | 'bif' | 'bmd' | 'myr' | 'bnd' | 'bob' | 'brl' | 'bsd' | 'btn' | 'nok' | 'zar' | 'bwp' | 'byn' | 'bzd' | 'cad' | 'cdf' | 'xaf' | 'chf' | 'nzd' | 'clp' | 'cny' | 'cop' | 'crc' | 'cve' | 'czk' | 'djf' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'mad' | 'etb' | 'fjd' | 'fkp' | 'jpy' | 'gbp' | 'gel' | 'ghs' | 'gip' | 'gmd' | 'gnf' | 'gtq' | 'gyd' | 'hkd' | 'hnl' | 'htg' | 'huf' | 'idr' | 'ils' | 'isk' | 'jmd' | 'jod' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kwd' | 'kyd' | 'kzt' | 'lak' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mur' | 'mvr' | 'mwk' | 'mxn' | 'mzn' | 'nad' | 'xpf' | 'ngn' | 'nio' | 'sek' | 'npr' | 'omr' | 'pab' | 'pen' | 'pgk' | 'php' | 'pln' | 'pyg' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sgd' | 'sle' | 'sos' | 'srd' | 'szl' | 'thb' | 'tjs' | 'tnd' | 'top' | 'try' | 'ttd' | 'twd' | 'tzs' | 'uah' | 'uyu' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'yer' | 'zmw', required — Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase.
  - `description` string, required — Description of the Fundraiser.
  - `designation` DesignationResponse, required — Contains information about the designation.
    - `code` string, nullable, required — Designation code.
    - `id` string, required — Unique designation identifier.
    - `name` string, nullable, required — Designation name.
  - `goal` FundraiserGoalResponse, required — Goal details for the Fundraiser, if set.
    - `amount` string, required — Target amount for the fundraiser.
    - `end_date` string, required — End date for the fundraiser goal.
  - `id` string, required — Unique identifier for the Fundraiser.
  - `image` FundraiserImageResponse, required — Image details for the Fundraiser, if available.
    - `preview_url` string, required — URL for the preview image.
  - `name` string, required — The title of the Fundraiser, used as its main heading.
  - `slug` string, nullable, required — Slug for the Fundraiser, if set.
  - `status` 'active' | 'paused', required — Current status of the Fundraiser.

## Other responses

- `403` — Forbidden. The API key does not have permission to update Fundraisers.

---

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