Skip to content
Aller au contenu
Charitips

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 · Campaign

No field is described in the spec.

  • campaignId#stringalways returned

  • name#stringalways returned

  • type#CampaignType

    TIME_BASEDPERMANENT

  • amountType#CampaignAmountType

    FIXED_AMOUNTFREE_AMOUNT

  • audienceType#CampaignAudienceType

    PRIVATEPUBLIC

  • donationType#CampaignDonationType

    FACE_VALUEDISTRIBUTION

  • givingType#GivingTypealways returned

    FINANCIALPAYROLLPAID_TIME_OFF

  • recurringType#RecurringTypealways returned

    NONEFREQUENCYMANUAL

  • startDate#string (date-time)always returned

  • endDate#string (date-time)

  • budget#integer (int64)

  • sendingMode#CampaignSendingMode

    MANUALEMAILPHYSICALSLACKPOSTAL

  • status#CampaignStatus

    DRAFTPENDINGACTIVECOMPLETECANCELED

  • slug#string

  • publicKey#stringalways returned

  • withFiscalReceipts#booleanalways returned

  • language#Language

    fren

  • frequency#string

  • budgetFrequency#string

  • billingStatus#BillingStatusalways returned

    PENDINGBILLEDPAID

  • defaultHideAmount#boolean

  • withHideAmountCustomization#boolean

  • withGiftCards#boolean

  • withLeadCollection#boolean

  • withoutCustomization#booleanalways returned

  • momentType#MomentType

    OCCASIONKEY_MOMENTEDITION

  • momentSlug#string

  • leadCollectionOptions#object

  • donationsBilledOn#DonationBilledOnalways returned

    CREATIONCLAIM

  • withDonationsValidation#booleanalways returned

  • fiscalReceiptType#FiscalReceiptTypealways returned

    YEARLYSINGLE_DONATION

  • fiscalReceiptSendingMode#FiscalReceiptSendingModealways returned

    MANUALEMAIL

  • defaultHasBeenCharged#booleanalways returned

  • defaultFeeType#FeeTypealways returned

    EXCLUDEDINCLUDED

  • donationValidityPeriod#stringalways returned

  • template#string

  • physicalFormat#PhysicalFormat

    CUSTOMPRINTPARCEL

  • withEmailWall#boolean

  • postDonationWidgets#PostDonationWidget[]always returned

  • title#string

  • description#string

  • logoUrl#string

  • faviconUrl#string

  • titleColor#string

  • accentColor#string

  • givingTarget#integer (int64)

  • message#string

  • reminderMessage#string

  • emailSenderName#string

  • emailSenderPictureUrl#string

  • emailSubject#string

  • emailTemplate#string

  • emailReplyTo#string

  • emailDisplayCard#boolean

  • lastCustomerReminderId#string

  • charitiesSelectionId#string

  • accountId#stringalways returned

  • campaignTemplateId#string

  • donorPlatformId#string

  • createdAt#string (date-time)always returned

  • updatedAt#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"
    }
POST /v1/campaigns/<campaignId>/activate
curl -X POST https://api.sandbox.charitips.com/v1/campaigns/<campaignId>/activate \  -H "Authorization: Bearer $CHARITIPS_TOKEN"
Built from the spec and the API code

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.