API reference · Campaigns
Close a campaign
POST/v1/campaigns/{campaignId}/close
Closing a campaign will change its status to COMPLETE, automatically assign any pending donations or remaining budget, generate a report with branded assets and issue fiscal receipts (if campaign.fiscalReceiptType = SINGLE_DONATION). No donation can be created afterwards. ⚠️ This operation is irreversible.
Requires a Bearer access token.
Parameters
This field has no description in the spec.
campaignId#stringin pathrequired
Response
200 · CampaignNo field is described in the spec.
campaignId#stringalways returnedname#stringalways returnedtype#CampaignTypeTIME_BASEDPERMANENTamountType#CampaignAmountTypeFIXED_AMOUNTFREE_AMOUNTaudienceType#CampaignAudienceTypePRIVATEPUBLICdonationType#CampaignDonationTypeFACE_VALUEDISTRIBUTIONgivingType#GivingTypealways returnedFINANCIALPAYROLLPAID_TIME_OFFrecurringType#RecurringTypealways returnedNONEFREQUENCYMANUALstartDate#string (date-time)always returnedendDate#string (date-time)budget#integer (int64)sendingMode#CampaignSendingModeMANUALEMAILPHYSICALSLACKPOSTALstatus#CampaignStatusDRAFTPENDINGACTIVECOMPLETECANCELEDslug#stringpublicKey#stringalways returnedwithFiscalReceipts#booleanalways returnedlanguage#Languagefrenfrequency#stringbudgetFrequency#stringbillingStatus#BillingStatusalways returnedPENDINGBILLEDPAIDdefaultHideAmount#booleanwithHideAmountCustomization#booleanwithGiftCards#booleanwithLeadCollection#booleanwithoutCustomization#booleanalways returnedmomentType#MomentTypeOCCASIONKEY_MOMENTEDITIONmomentSlug#stringleadCollectionOptions#objectdonationsBilledOn#DonationBilledOnalways returnedCREATIONCLAIMwithDonationsValidation#booleanalways returnedfiscalReceiptType#FiscalReceiptTypealways returnedYEARLYSINGLE_DONATIONfiscalReceiptSendingMode#FiscalReceiptSendingModealways returnedMANUALEMAILdefaultHasBeenCharged#booleanalways returneddefaultFeeType#FeeTypealways returnedEXCLUDEDINCLUDEDdonationValidityPeriod#stringalways returnedtemplate#stringphysicalFormat#PhysicalFormatCUSTOMPRINTPARCELwithEmailWall#booleanpostDonationWidgets#PostDonationWidget[]always returnedtitle#stringdescription#stringlogoUrl#stringfaviconUrl#stringtitleColor#stringaccentColor#stringgivingTarget#integer (int64)message#stringreminderMessage#stringemailSenderName#stringemailSenderPictureUrl#stringemailSubject#stringemailTemplate#stringemailReplyTo#stringemailDisplayCard#booleanlastCustomerReminderId#stringcharitiesSelectionId#stringaccountId#stringalways returnedcampaignTemplateId#stringdonorPlatformId#stringcreatedAt#string (date-time)always returnedupdatedAt#string (date-time)always returned
Errors
401Unauthorized
Missing, expired or invalid access token.
{ "statusCode": 401, "message": "Unauthorized" }403A FIXED_AMOUNT campaign cannot be closed before its first donation or vote.
{ "message": "A FIXED_AMOUNT campaign cannot be closed before its first donation or vote.", "code": "NOTHING_TO_CLOSE" }403Account closed
{ "message": "Account closed", "code": "ACCOUNT_CLOSED" }403Forbidden
Your credentials cannot perform this action on this resource. An id from another account answers 404 in the path, 400 in the body or the query.
{ "statusCode": 403, "message": "Forbidden" }404Not Found
No resource with this id on your account: the API answers as if it did not exist.
{ "statusCode": 404, "message": "Not Found" }
curl -X POST https://api.sandbox.charitips.com/v1/campaigns/<campaignId>/close \ -H "Authorization: Bearer $CHARITIPS_TOKEN"Request bodies are written for this docs and checked against the API's validation; ids in angle brackets are placeholders. Response values are placeholders built from the schema.