--- title: "Create a Fundraiser" method: POST path: "/v1/fundraisers" tags: ["Fundraisers"] --- # Create a Fundraiser `POST /v1/fundraisers` This request allows you to create a Fundraiser — a supporter-led fundraising page connected to a specific campaign. Learn more about [how Fundraisers work](https://fundraiseup.com/docs/fundraiser/) in Fundraise Up. ## Request body - CreateFundraiserRequest — Contains the request parameters required for creating a Fundraiser. - `campaign` string, required — 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. - `description` string, required — Description of the Fundraiser - `name` string, required — The title of the Fundraiser, used as its main heading. - `code` string — Identifier of up to 150 characters. Does not need to be unique. - `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' — Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. - `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`. - `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 created Fundraiser object. If any parameters are invalid, the request returns an error response. - 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 create 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)