API reference · Campaigns
Activate a campaign
POST/v1/campaigns/{campaignId}/activate
Once properly setup, activate your campaign to start registring donations.
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
- 400 Bad Request
No charity selection linked to this campaign
{ "statusCode": 400, "message": "No charity selection linked to this campaign", "error": "Bad Request" }No budget set for this campaign
{ "message": "No budget set for this campaign", "code": "MISSING_BUDGET" }Campaign budget exceeds payment card amount limit
{ "message": "Campaign budget exceeds payment card amount limit", "code": "PAYMENT_CARD_AMOUNT_LIMIT_EXCEEDED" }Campaign budget exceeds SEPA Direct Debit amount limit
{ "message": "Campaign budget exceeds SEPA Direct Debit amount limit", "code": "SDD_AMOUNT_LIMIT_EXCEEDED" }Invoice amount <amount_due> is over the SDD limit <SDD_AMOUNT_LIMIT>
{ "message": "Invoice amount <amount_due> is over the SDD limit <SDD_AMOUNT_LIMIT>", "code": "SDD_AMOUNT_LIMIT_EXCEEDED" }Invoice amount <amount_due> is over the payment card limit <PAYMENT_CARD_AMOUNT_LIMIT>
{ "message": "Invoice amount <amount_due> is over the payment card limit <PAYMENT_CARD_AMOUNT_LIMIT>", "code": "PAYMENT_CARD_AMOUNT_LIMIT_EXCEEDED" }- 401 Unauthorized
Unauthorized
Missing, expired or invalid access token.
{ "statusCode": 401, "message": "Unauthorized" }- 402 Payment Required
No active subscription found
{ "message": "No active subscription found", "code": "NO_ACTIVE_SUBSCRIPTION" }Missing payment method
{ "message": "Missing payment method", "code": "MISSING_PAYMENT_METHOD" }- 403 Forbidden
Campaign has ended.
{ "statusCode": 403, "message": "Campaign has ended.", "error": "Forbidden" }Campaign is waiting for payment
{ "statusCode": 403, "message": "Campaign is waiting for payment", "error": "Forbidden" }Account not validated
{ "statusCode": 403, "message": "Account not validated", "error": "Forbidden" }Account closed
{ "message": "Account closed", "code": "ACCOUNT_CLOSED" }Forbidden
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" }- 404 Not Found
Not 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>/activate \ -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.