Errors

How to fix: message lists every problem. Unknown fields are rejected, not ignored: remove them rather than sending extra data.

{
  "statusCode": 400,
  "message": [
    "amount must not be less than 1",
    "property foo should not exist"
  ],
  "error": "Bad Request"
}

Returned by:Create an admin widget tokenCreate a donor widget tokenCreate a donor platform widget tokenList accountsGet an accountUpdate an accountCreate an invitationList child accountsCreate a child accountEnable donor platformGet payment detailsGet a charityand 60 more

How to fix: A custom domain cannot contain a Charitips domain (charitips.com, charitips.net, charitips.org, charitips.tech, chari.tips). Use a domain you own, or subdomain for an address under Charitips. Create a site

{
  "statusCode": 400,
  "message": "Invalid customDomain",
  "error": "Bad Request"
}

Returned by:Update an accountCreate a child accountCreate a siteUpdate a site

How to fix: At least one id of campaignIds is not a campaign of this account, or an id is repeated. List the account's campaigns and send each id once. List campaigns

{
  "statusCode": 400,
  "message": "Invalid campaignIds",
  "error": "Bad Request"
}

Returned by:Create an invitationUpdate a user invitationUpdate a user

How to fix: Add at least one charity to the selection before linking it to a campaign. Add a charity

{
  "statusCode": 400,
  "message": "A selection must have at least one charity when linked to a campaign",
  "error": "Bad Request"
}

Returned by:Update a charities selectionRemove a charity

How to fix: The campaignId does not exist on your account and environment. Ids from the sandbox do not exist in production.

{
  "statusCode": 400,
  "message": "Bad Request"
}

Returned by:Create a recurring donationCreate a vote

How to fix: Pass both donor.email and donor.firstName. Create a donation

{
  "statusCode": 400,
  "message": "Both donor.email and donor.firstName are required for email campaigns",
  "error": "Bad Request"
}

Returned by:Create a donationCreate a vote

How to fix: Pass both donor.slackId and donor.firstName. Create a donation

{
  "statusCode": 400,
  "message": "Both donor.slackId and donor.firstName are required for slack campaigns",
  "error": "Bad Request"
}

Returned by:Create a donationCreate a vote

How to fix: Set budget, in cents, when amountType is FIXED_AMOUNT. Create a campaign

{
  "statusCode": 400,
  "message": "Budget is required for FIXED_AMOUNT campaigns",
  "error": "Bad Request"
}

Returned by:Enable donor platformCreate a campaign

How to fix: A DISTRIBUTION campaign shares a fixed budget: set amountType to FIXED_AMOUNT and a budget. Create a campaign

{
  "statusCode": 400,
  "message": "DISTRIBUTION campaigns must also be FIXED_AMOUNT campaigns",
  "error": "Bad Request"
}

Returned by:Enable donor platformCreate a campaign

How to fix: EMAIL campaigns send the donation to someone: pass donor with at least email and firstName. Create a donation

{
  "statusCode": 400,
  "message": "donor is required for EMAIL campaigns.",
  "error": "Bad Request"
}

Returned by:Create a donationCreate a vote

How to fix: SLACK campaigns send the donation in Slack: pass donor with slackId and firstName. Create a donation

{
  "statusCode": 400,
  "message": "donor is required for SLACK campaigns.",
  "error": "Bad Request"
}

Returned by:Create a donationCreate a vote

How to fix: featuredCharitiesIds names charities that are not in the selection: the message lists them. Add them to charityIds, or leave them out of featuredCharitiesIds. Charities and selections

{
  "statusCode": 400,
  "message": "Featured charities must be part of the selected charities: <join(', ')>",
  "error": "Bad Request"
}

Returned by:Create a charities selectionUpdate a charities selection

{
  "statusCode": 400,
  "message": "givingTarget is only supported for fundraising campaigns",
  "error": "Bad Request"
}

Returned by:Enable donor platformCreate a campaign

{
  "statusCode": 400,
  "message": "INCLUDED fee type not supported",
  "error": "Bad Request"
}

Returned by:Enable donor platformCreate a campaign

How to fix: This donation would take the campaign over its budget. Create a smaller donation, or use another campaign: the API does not change the budget of an existing campaign.

{
  "message": "Insufficient campaign budget.",
  "code": "INSUFFICIENT_CAMPAIGN_BUDGET"
}

Returned by:Create a donationClaim a recurring donation

How to fix: The selection does not exist on your account. List your selections, or create one. List charities selections

{
  "statusCode": 400,
  "message": "Invalid charitiesSelectionId",
  "error": "Bad Request"
}

Returned by:Create a campaignUpdate a campaign

How to fix: includeDonor is not available with API credentials. Remove it, and read the donor with its own endpoint. Get a donor

{
  "statusCode": 400,
  "message": "Invalid parameter includeDonor",
  "error": "Bad Request"
}

Returned by:List donationsList votes

How to fix: The part before your own subdomain must be a single label: 1 to 63 lowercase letters, digits or hyphens, no dot, not starting or ending with a hyphen. Donations for your business customers

{
  "statusCode": 400,
  "message": "Nested subdomains are not allowed",
  "error": "Bad Request"
}

Returned by:Update an accountCreate a child account

How to fix: campaignIds only apply to the MEMBER role, and the check reads the role saved before this call. Set role to MEMBER in a first update, then send campaignIds, or leave campaignIds out. Account hierarchy

{
  "statusCode": 400,
  "message": "Only members can be assigned campaigns",
  "error": "Bad Request"
}

Returned by:Update a user invitationUpdate a user

{
  "statusCode": 400,
  "message": "Only one of <givingType> campaigns is supported",
  "error": "Bad Request"
}

Returned by:Enable donor platformCreate a campaign

How to fix: A PUBLIC campaign is a vote on a fixed budget: set amountType FIXED_AMOUNT and donationType DISTRIBUTION, or keep it PRIVATE. Create a campaign

{
  "statusCode": 400,
  "message": "Public campaigns must be both FIXED_AMOUNT and DISTRIBUTION campaigns",
  "error": "Bad Request"
}

Returned by:Enable donor platformCreate a campaign

How to fix: A child account's subdomain sits under yours: send <child>.<your subdomain>, for example shop.acme when your subdomain is acme. The message gives your subdomain. Donations for your business customers

{
  "statusCode": 400,
  "message": "Subdomain must ends with .<subdomain>",
  "error": "Bad Request"
}

Returned by:Update an accountCreate a child account

How to fix: You sent campaignId: pass at least one id in charityIds as well, or create the selection without campaignId. Create a charities selection

{
  "statusCode": 400,
  "message": "A selection must have at least one charity to be linked to a campaign",
  "error": "Bad Request"
}

Returned by:Create a charities selection

How to fix: With authenticationStrategy BEARER, pass the accessToken Charitips will send to your endpoint. Webhooks

{
  "statusCode": 400,
  "message": "accessToken is required for Bearer authentication",
  "error": "Bad Request"
}

Returned by:Create a webhook

{
  "statusCode": 400,
  "message": "accountId is required when includeCampaigns is true",
  "error": "Bad Request"
}

Returned by:List campaign templates

How to fix: A MEMBER only sees the campaigns they are given. Send campaignIds with at least one campaign of the account, or invite the user as ADMIN or PAYROLL_MANAGER. Create an invitation

{
  "statusCode": 400,
  "message": "At least one campaign is required for members",
  "error": "Bad Request"
}

Returned by:Create an invitation

How to fix: Send subdomain, customDomain, or both. Create a site

{
  "statusCode": 400,
  "message": "At least one of subdomain and customDomain is required.",
  "error": "Bad Request"
}

Returned by:Create a site

How to fix: The campaignId does not exist on your account and environment. Ids from the sandbox do not exist in production.

{
  "message": "Bad Request",
  "code": "INVALID_POSTAL_ADDRESS"
}

Returned by:Create a donation

How to fix: With authenticationStrategy BASIC, pass the username and password Charitips will send to your endpoint. Webhooks

{
  "statusCode": 400,
  "message": "Both username and password are required for Basic authentication",
  "error": "Bad Request"
}

Returned by:Create a webhook

How to fix: The amount to charge (the budget, the usage not billed yet and the fees) is above what the account's payment card can be charged at once. Create the campaign with a lower budget, or switch to another payment method, such as a bank transfer, in the dashboard, under Settings > Billing. The sandbox never returns this error. Create a campaign

{
  "message": "Campaign budget exceeds payment card amount limit",
  "code": "PAYMENT_CARD_AMOUNT_LIMIT_EXCEEDED"
}

Returned by:Activate a campaign

How to fix: The amount to charge (the budget, the usage not billed yet and the fees) is above what a SEPA direct debit can take at once. Create the campaign with a lower budget, or switch to another payment method, such as a bank transfer, in the dashboard, under Settings > Billing. The sandbox never returns this error. Create a campaign

{
  "message": "Campaign budget exceeds SEPA Direct Debit amount limit",
  "code": "SDD_AMOUNT_LIMIT_EXCEEDED"
}

Returned by:Activate a campaign

How to fix: On a DISTRIBUTION campaign, people vote on a budget: create a vote, not a donation. Create a vote

{
  "statusCode": 400,
  "message": "Campaign is a DISTRIBUTION one. Only votes can be created",
  "error": "Bad Request"
}

Returned by:Create a donation

How to fix: On a FACE_VALUE campaign, each person gives an amount: create a donation, not a vote. Create a donation

{
  "statusCode": 400,
  "message": "Campaign is a FACE_VALUE one. Only donations can be created",
  "error": "Bad Request"
}

Returned by:Create a vote

How to fix: A campaign that is ACTIVE, PENDING or DRAFT still uses this selection. Give those campaigns another selection, or delete it once they are complete or canceled. List campaigns

{
  "statusCode": 400,
  "message": "Cannot delete a charities selection with active campaigns",
  "error": "Bad Request"
}

Returned by:Delete a charities selection

{
  "statusCode": 400,
  "message": "charityId cannot be set for POSTAL campaigns: the recipient chooses the charity with the card.",
  "error": "Bad Request"
}

Returned by:Create a donation

How to fix: Claim the donation for a charity first. Claim a donation

{
  "statusCode": 400,
  "message": "Donation not claimed yet",
  "error": "Bad Request"
}

Returned by:Validate a donation

{
  "statusCode": 400,
  "message": "Donations of an order campaign cannot be created through the API.",
  "error": "Bad Request"
}

Returned by:Create a donation

{
  "statusCode": 400,
  "message": "Exactly 3 START and 3 END reminders are required",
  "error": "Bad Request"
}

Returned by:Update campaign reminders

How to fix: Set authenticationStrategy to BASIC (with username and password) or BEARER (with accessToken). Webhooks

{
  "statusCode": 400,
  "message": "Invalid authenticationStrategy",
  "error": "Bad Request"
}

Returned by:Create a webhook

{
  "statusCode": 400,
  "message": "Invalid campaignReminderId",
  "error": "Bad Request"
}

Returned by:Update campaign reminders

How to fix: A donor platform token can only change the donor's own profile: firstName, lastName, phone, pictureUrl, birthdate, personalEmail, title, persona, hasAcceptedTerms, street, zip, city and country. Remove the fields listed in the message. Update a donor

{
  "statusCode": 400,
  "message": "Invalid fields: <join(', ')>",
  "error": "Bad Request"
}

Returned by:Update a donor

How to fix: A field enabled in the campaign's leadCollectionOptions (fullname, companyName, email, phone or custom) is missing from lead. Claim a donation

{
  "statusCode": 400,
  "message": "Invalid lead information",
  "error": "Bad Request"
}

Returned by:Claim a donation

{
  "statusCode": 400,
  "message": "Invalid parentDonationId",
  "error": "Bad Request"
}

Returned by:Create a donation

How to fix: The budget of the campaign is invoiced at activation, and the invoice is above what the payment card can be charged at once. Create the campaign with a lower budget, or switch to another payment method, such as a bank transfer, in the dashboard, under Settings > Billing. The sandbox never returns this error. Create a campaign

{
  "message": "Invoice amount <amount_due> is over the payment card limit <PAYMENT_CARD_AMOUNT_LIMIT>",
  "code": "PAYMENT_CARD_AMOUNT_LIMIT_EXCEEDED"
}

Returned by:Activate a campaign

How to fix: The budget of the campaign is invoiced at activation, and the invoice is above what a SEPA direct debit can take at once. Create the campaign with a lower budget, or switch to another payment method, such as a bank transfer, in the dashboard, under Settings > Billing. The sandbox never returns this error. Create a campaign

{
  "message": "Invoice amount <amount_due> is over the SDD limit <SDD_AMOUNT_LIMIT>",
  "code": "SDD_AMOUNT_LIMIT_EXCEEDED"
}

Returned by:Activate a campaign

How to fix: This is the campaign's own language: its texts are the campaign fields. Update the campaign to change them, or send another language. Update a campaign

{
  "statusCode": 400,
  "message": "Language is already the default language",
  "error": "Bad Request"
}

Returned by:Add a campaign translation

How to fix: The campaign does not collect leads: remove lead from the claim, or create the campaign with withLeadCollection and leadCollectionOptions. Create a campaign

{
  "statusCode": 400,
  "message": "Lead collection is not enabled for this campaign",
  "error": "Bad Request"
}

Returned by:Claim a donation

How to fix: Set lead.hasAcceptedTerms to true once the person has accepted the terms. Claim a donation

{
  "statusCode": 400,
  "message": "Lead has to accept terms and conditions",
  "error": "Bad Request"
}

Returned by:Claim a donation

How to fix: The campaign collects the donor's details at the claim: pass lead with the fields enabled in the campaign's leadCollectionOptions and hasAcceptedTerms set to true. Claim a donation

{
  "statusCode": 400,
  "message": "Lead is required",
  "error": "Bad Request"
}

Returned by:Claim a donation

How to fix: params must carry campaignId (required for PRINT_PHYSICAL_CARDS_PDF) or fileRefs. Send one of them. Create a file generation request

{
  "statusCode": 400,
  "message": "Missing params in createFileGenerationRequest",
  "error": "Bad Request"
}

Returned by:Create a file generation request

How to fix: A campaign with amountType: FIXED_AMOUNT needs a budget in cents, and the API cannot add one after creation. Create the campaign again with its budget, then activate it. Create a campaign

{
  "message": "No budget set for this campaign",
  "code": "MISSING_BUDGET"
}

Returned by:Activate a campaign

How to fix: Create a charities selection with at least one charity, set it on the campaign with charitiesSelectionId, then activate. Create a charities selection

{
  "statusCode": 400,
  "message": "No charity selection linked to this campaign",
  "error": "Bad Request"
}

Returned by:Activate a campaign

How to fix: The billing link is built on your own account's site. Every account gets its site when its onboarding is completed, so your account should have one: contact us. Create a shareable billing link

{
  "statusCode": 400,
  "message": "No domain found for your account",
  "error": "Bad Request"
}

Returned by:Create a shareable billing link

How to fix: Send accountId for the metrics of one account, or includeChildAccountsCampaigns=true to add your child accounts' campaigns to yours, not both. Get all campaigns metrics

{
  "statusCode": 400,
  "message": "Only one of accountId or includeChildAccountsCampaigns can be used",
  "error": "Bad Request"
}

Returned by:Get all campaigns metrics

How to fix: Use a campaign with amountType FREE_AMOUNT for recurring donations. Create a campaign

{
  "statusCode": 400,
  "message": "Recurring donations can only be created for FREE_AMOUNT campaigns",
  "error": "Bad Request"
}

Returned by:Create a recurring donation

{
  "statusCode": 400,
  "message": "Reminder type is required for each reminder",
  "error": "Bad Request"
}

Returned by:Update campaign reminders

How to fix: Cast the vote for a charity first. Cast a vote

{
  "statusCode": 400,
  "message": "Vote not casted yet",
  "error": "Bad Request"
}

Returned by:Validate a vote

{
  "statusCode": 400,
  "message": "Votes cannot be posted.",
  "error": "Bad Request"
}

Returned by:Create a vote

{
  "statusCode": 401,
  "message": "Unauthorized"
}

Returned by:Create a tokenCreate a user magic linkCreate a donor magic linkCreate an admin widget tokenCreate a donor widget tokenCreate a donor platform widget tokenLogout a userLogout a donorList accountsGet an accountUpdate an accountCreate an invitationand 101 more

How to fix: The client id or secret is wrong, or the pair belongs to the other environment: sandbox credentials start with test_ and only work on api.sandbox.charitips.com. Send them as Basic authentication (-u id:secret). Sandbox

{
  "statusCode": 401,
  "message": "Invalid credentials",
  "error": "Unauthorized"
}

Returned by:Create a token

How to fix: Your plan does not include this feature. Upgrade the plan from the dashboard, then retry. Plans and prerequisites

{
  "statusCode": 402,
  "message": "Plan upgrade required"
}

Returned by:Create a donor widget tokenCreate a donor platform widget tokenUpdate an accountCreate an invitationCreate a child accountCreate a shareable billing linkEnable donor platformDisable a donor platformCreate a donation fiscal receiptFind donor fiscal receiptsFind donor payment methodsCreate a siteand 5 more

How to fix: The account that pays for the donations (your (parent) account or a child account if they are billed directly) has no payment method. Add one in the dashboard, under Settings > Billing, then retry. On the sandbox, creating a single donation skips this check, but other calls can still return it, like activating a FIXED_AMOUNT campaign that is billed on order. Billing and fiscal receipts

{
  "message": "Missing payment method",
  "code": "MISSING_PAYMENT_METHOD"
}

Returned by:Activate a campaignCreate a donationCreate a recurring donation

How to fix: The account has no active monthly subscription, so the campaign cannot be activated. Contact us if you sandbox account has no subscription. Plans and prerequisites

{
  "message": "No active subscription found",
  "code": "NO_ACTIVE_SUBSCRIPTION"
}

Returned by:Activate a campaign

How to fix: The account behind these credentials is closed: no token is issued and every call is refused, reads included. Contact Charitips to reopen it. Troubleshooting

{
  "message": "Account closed",
  "code": "ACCOUNT_CLOSED"
}

Returned by:Create a tokenCreate a user magic linkCreate a donor magic linkCreate an admin widget tokenCreate a donor widget tokenCreate a donor platform widget tokenLogout a userLogout a donorList accountsGet an accountUpdate an accountCreate an invitationand 100 more

How to fix: Your credentials cannot perform this action on this resource. An id from another account never answers 403: it is treated as unknown, with a 404 in the path or a 400 Bad Request in the body or the query.

{
  "statusCode": 403,
  "message": "Forbidden"
}

Returned by:Create a user magic linkCreate a donor magic linkCreate a donor platform widget tokenLogout a userLogout a donorGet an accountUpdate an accountCreate an invitationCreate a child accountList account reportsCreate a shareable billing linkGet payment methodsand 47 more

How to fix: The account behind your credentials has not finished onboarding. Complete it in the dashboard, or contact us. Troubleshooting

{
  "statusCode": 403,
  "message": "Account not validated",
  "error": "Forbidden"
}

Returned by:Create a campaignActivate a campaignCreate a donationClaim a donationCreate a recurring donationClaim a recurring donationCreate a siteCreate a voteCast a vote

How to fix: The campaign is COMPLETE or CANCELED: nothing can be created, claimed or cast on it any more. Use an active campaign. List campaigns

{
  "statusCode": 403,
  "message": "Campaign has ended.",
  "error": "Forbidden"
}

Returned by:Activate a campaignCreate a donationClaim a donationCreate a recurring donationClaim a recurring donationCreate a voteCast a vote

How to fix: Activate the campaign once it has its charities selection, then retry. Activate a campaign

{
  "statusCode": 403,
  "message": "Campaign has to be activated first.",
  "error": "Forbidden"
}

Returned by:Create a donationCreate a recurring donationCreate a vote

How to fix: The selection belongs to a campaign whose charities cannot be changed. Create a new selection for your campaign. Create a charities selection

{
  "statusCode": 403,
  "message": "This selection can't be customized",
  "error": "Forbidden"
}

Returned by:Update a charities selectionAdd a charityRemove a charity

How to fix: The donation is still being processed. Wait for the donation_update webhook, then retry. Webhooks

{
  "statusCode": 403,
  "message": "Donation has not been processed yet.",
  "error": "Forbidden"
}

Returned by:Create a donation fiscal receiptGet a donation fiscal receipt

How to fix: This campaign has a recurring frequency: create a recurring donation. Create a recurring donation

{
  "statusCode": 403,
  "message": "Only recurring donations can be created for recurring campaigns.",
  "error": "Forbidden"
}

Returned by:Create a donationCreate a vote

How to fix: A child's subdomain is built under your own subdomain, and your account has none. Contact us to set it up, or give the child account a customDomain instead. Donations for your business customers

{
  "statusCode": 403,
  "message": "Parent account is missing a domain",
  "error": "Forbidden"
}

Returned by:Update an accountCreate a child account

{
  "message": "A FIXED_AMOUNT campaign cannot be closed before its first donation or vote.",
  "code": "NOTHING_TO_CLOSE"
}

Returned by:Close a campaign

How to fix: The account behind these credentials has not finished onboarding, so no token is issued. Complete the onboarding in the dashboard, or contact us. Troubleshooting

{
  "statusCode": 403,
  "message": "Account not active",
  "error": "Forbidden"
}

Returned by:Create a token

How to fix: The user's account does not list API in its authSchemes, so no magic link can be made for its users. authSchemes is set when the child account is created; contact us to change it. Create a child account

{
  "message": "API authentication is not allowed for this account",
  "code": "API_AUTH_NOT_ALLOWED"
}

Returned by:Create a user magic link

How to fix: The donor platform does not list API in its authSchemes. Disable the donor platform, then enable it again with API in authSchemes. Enable donor platform

{
  "message": "API authentication is not allowed for this donor platform",
  "code": "API_AUTH_NOT_ALLOWED"
}

Returned by:Create a donor magic link

How to fix: With an API token, the billing link needs billing delegation: the account must be billed to itself (billedTo ACCOUNT) and your plan must include delegated billing. Contact us to enable it. Bill your business customers

{
  "statusCode": 403,
  "message": "Billing delegation is not enabled for this account",
  "error": "Forbidden"
}

Returned by:Create a shareable billing link

How to fix: The fixed budget of the campaign has been invoiced and is not paid yet. Pay the invoice, then activate. List invoices

{
  "statusCode": 403,
  "message": "Campaign is waiting for payment",
  "error": "Forbidden"
}

Returned by:Activate a campaign

How to fix: A user session cannot delete its own user: another admin has to do it. An API token is not a user, so it never gets this error. Delete a user

{
  "statusCode": 403,
  "message": "Can't delete yourself",
  "error": "Forbidden"
}

Returned by:Delete a user

How to fix: This is the selection created with your account, and it cannot be deleted. Change its charities instead. Update a charities selection

{
  "statusCode": 403,
  "message": "Cannot delete a featured charities selection",
  "error": "Forbidden"
}

Returned by:Delete a charities selection

How to fix: Accounts with account hierarchy can set a custom domain only on their child accounts: the accountId in the path is your own account. Use the site endpoints for your own domains. Update a site

{
  "statusCode": 403,
  "message": "Custom domain can't be updated for parent accounts",
  "error": "Forbidden"
}

Returned by:Update an account

How to fix: The donation is on an invoice and cannot be deleted. Refund it in your own books; delete a donation before it is billed. Delete a donation

{
  "statusCode": 403,
  "message": "Donation already invoiced",
  "error": "Forbidden"
}

Returned by:Delete a donation

How to fix: The invoice carrying this donation has been paid, so it cannot be deleted. Refund it in your own books. Delete a donation

{
  "statusCode": 403,
  "message": "Donation already paid",
  "error": "Forbidden"
}

Returned by:Delete a donation

How to fix: The donation has reached the PROCESSED status and cannot be deleted. Refund it in your own books. Delete a donation

{
  "statusCode": 403,
  "message": "Donation already processed",
  "error": "Forbidden"
}

Returned by:Delete a donation

How to fix: Once billed, the amount is final. Create a new donation for a different amount. Create a donation

{
  "statusCode": 403,
  "message": "Donation amount can't be updated as it has already been billed.",
  "error": "Forbidden"
}

Returned by:Update a donation

How to fix: Once claimed, the amount is final. Create a new donation for a different amount. Create a donation

{
  "statusCode": 403,
  "message": "Donation amount can't be updated as it has already been claimed.",
  "error": "Forbidden"
}

Returned by:Update a donation

{
  "statusCode": 403,
  "message": "Donation amount can't be updated as it has been claimed, billed or its card posted.",
  "error": "Forbidden"
}

Returned by:Update a donation

{
  "statusCode": 403,
  "message": "Donation amount can't be updated as its card has already been posted.",
  "error": "Forbidden"
}

Returned by:Update a donation

{
  "statusCode": 403,
  "message": "Donation card already posted",
  "error": "Forbidden"
}

Returned by:Delete a donation

How to fix: A fiscal receipt needs the donor's first name, last name, street, zip, city and country. Complete the donor, or set withFiscalReceipt to false. Your users give their own money

{
  "statusCode": 403,
  "message": "Donor is missing required fiscal information.",
  "error": "Forbidden"
}

Returned by:Create a donation fiscal receipt

How to fix: The donor's account has no enabled donor platform. Enable it first, then retry. Enable donor platform

{
  "statusCode": 403,
  "message": "Donor platform is not enabled",
  "error": "Forbidden"
}

Returned by:Create a donor magic link

How to fix: Accounts with account hierarchy cannot create a subdomain site. Create the site with customDomain; for a child account, the parent sets its subdomain with update-account. Update an account

{
  "statusCode": 403,
  "message": "New subdomain site can't be created",
  "error": "Forbidden"
}

Returned by:Create a site

How to fix: A donor's fiscal receipt exists only for a donation the donor paid for. Create the donation with hasBeenCharged set to true, which needs the B2C use case on your account. Your users give their own money

{
  "statusCode": 403,
  "message": "Only avaible for donation created with hasBeenCharged set to true.",
  "error": "Forbidden"
}

Returned by:Create a donation fiscal receipt

How to fix: The donation was created without a fiscal receipt. Create it with withFiscalReceipt set to true, or leave the field out on a campaign that issues receipts. Your users give their own money

{
  "statusCode": 403,
  "message": "Only avaible for donation created with withFiscalReceipt set to true.",
  "error": "Forbidden"
}

Returned by:Create a donation fiscal receipt

How to fix: Only your CUSTOM selections can be deleted. GENERIC selections are shared by Charitips with every account and cannot be deleted. Charities and selections

{
  "statusCode": 403,
  "message": "Only CUSTOM charities selections can be deleted",
  "error": "Forbidden"
}

Returned by:Delete a charities selection

{
  "statusCode": 403,
  "message": "Only draft or not billed pending campaigns can be deleted",
  "error": "Forbidden"
}

Returned by:Delete a campaign

How to fix: The invitation was already accepted or canceled. If it was accepted, delete the user instead. Delete a user

{
  "statusCode": 403,
  "message": "Only pending invites can be deleted",
  "error": "Forbidden"
}

Returned by:Delete a user invitation

How to fix: Recurring donations need a campaign whose recurringType is FREQUENCY. Read the campaign to check it. recurringType cannot be set when you create a campaign: it comes from the campaign template. Monthly giving by your users

{
  "statusCode": 403,
  "message": "Recurring donations can only be created for recurring frequency campaigns.",
  "error": "Forbidden"
}

Returned by:Create a recurring donation

How to fix: Accounts with account hierarchycannot change a site's subdomain here; customDomain can still be changed. For a child account, the parent sets the subdomain with update-account. Update an account

{
  "statusCode": 403,
  "message": "Subdomain can't be updated",
  "error": "Forbidden"
}

Returned by:Update a site

How to fix: Accounts with account hierarchy can set a subdomain only on their child accounts: the accountId in the path is your own account. List child accounts

{
  "statusCode": 403,
  "message": "Subdomain can't be updated for parent accounts",
  "error": "Forbidden"
}

Returned by:Update an account

How to fix: This campaign keeps the charities it was created with: its charitiesSelectionId cannot change. Leave the field out, or create a new campaign with your selection. Create a campaign

{
  "statusCode": 403,
  "message": "The charities of this campaign cannot be customized",
  "error": "Forbidden"
}

Returned by:Update a campaign

How to fix: Not every charity can issue a receipt. Read fiscalReceiptsSupport on the charity before promising one: only ENABLED charities issue receipts. Get a charity

{
  "statusCode": 403,
  "message": "This charity does not support fiscal receipts.",
  "error": "Forbidden"
}

Returned by:Create a donation fiscal receipt

How to fix: The vote is on an invoice and cannot be deleted. Delete a vote

{
  "statusCode": 403,
  "message": "Vote already billed",
  "error": "Forbidden"
}

Returned by:Delete a vote

How to fix: The vote has been sent to the person and cannot be deleted. Delete a vote

{
  "statusCode": 403,
  "message": "Vote already sent",
  "error": "Forbidden"
}

Returned by:Delete a vote

How to fix: The vote has been cast and cannot be deleted. Delete a vote

{
  "statusCode": 403,
  "message": "Vote already used",
  "error": "Forbidden"
}

Returned by:Delete a vote

How to fix: No resource with this id on your account and environment. An id that belongs to another account answers 404 too when it is in the path. Ids from the sandbox do not exist in production. Sandbox

{
  "statusCode": 404,
  "message": "Not Found"
}

Returned by:Create a user magic linkCreate a donor magic linkCreate a donor platform widget tokenLogout a userLogout a donorGet an accountUpdate an accountCreate an invitationCreate a child accountList account reportsCreate a shareable billing linkGet payment methodsand 59 more

How to fix: No donor with this id belongs to the account as a whole: the id is wrong, or the donor was created with a donation, for one campaign only, and cannot sign in to the donor platform. Create the donor with create-donor. Create a donor

{
  "statusCode": 404,
  "message": "Donor not found",
  "error": "Not Found"
}

Returned by:Create a donor magic link

How to fix: The donor platform is not enabled on this account, so there is nothing to disable. Enable donor platform

{
  "statusCode": 404,
  "message": "Donor platform not found",
  "error": "Not Found"
}

Returned by:Disable a donor platform

How to fix: The donation has been processed but has no fiscal receipt yet. Create it with Create a donation fiscal receipt, or wait for the fiscalreceipt_generated webhook. Create a donation fiscal receipt

{
  "statusCode": 404,
  "message": "Fiscal receipt not found.",
  "error": "Not Found"
}

Returned by:Get a donation fiscal receipt

{
  "statusCode": 409,
  "message": "Unique constraint failed on uniqueExternalId"
}

Returned by:Create a donationUpdate a donationCreate a donorUpdate a donorCreate a recurring donationUpdate a recurring donationCreate a voteUpdate a vote

How to fix: Another campaign of your account already uses this slug. Pick another one.

{
  "message": "Slug already used",
  "code": "slug_already_used"
}

Returned by:Enable donor platformCreate a campaignUpdate a campaign

How to fix: This subdomain or custom domain is already used by a Charitips site, possibly one of your own accounts. Pick another one, or detach it from the other site first. Create a child account

{
  "message": "Domain already exists",
  "code": "domain_already_exist"
}

Returned by:Create a child account

How to fix: The donation is no longer waiting for a claim: it is already linked to a charity, by your previous claim or automatically, or it was canceled. Read the donation: status and charityId tell which. Get a donation

{
  "statusCode": 409,
  "message": "Donation already claimed",
  "error": "Conflict"
}

Returned by:Claim a donation

How to fix: The donation is no longer pending: it was validated already, it was done without validation because this campaign does not ask for it, or it was canceled. Read the donation to see its status. Get a donation

{
  "statusCode": 409,
  "message": "Donation already validated",
  "error": "Conflict"
}

Returned by:Validate a donation

How to fix: A pending invitation already exists for this email on this account. Update it or delete it instead of inviting again. List user invitations

{
  "statusCode": 409,
  "message": "Invitation already exist",
  "error": "Conflict"
}

Returned by:Create an invitation

How to fix: A canceled recurring donation cannot be claimed. Create a new one. Create a recurring donation

{
  "statusCode": 409,
  "message": "Recurring donation has been canceled",
  "error": "Conflict"
}

Returned by:Claim a recurring donation

How to fix: A user with this email already belongs to this account. Update the user instead of inviting them. Update a user

{
  "statusCode": 409,
  "message": "User already exist",
  "error": "Conflict"
}

Returned by:Create an invitation

How to fix: The vote has already been cast: your previous call succeeded. Get a vote

{
  "statusCode": 409,
  "message": "Vote already casted",
  "error": "Conflict"
}

Returned by:Cast a vote

How to fix: The vote is no longer pending: it was validated already, or it was done when cast because this campaign does not ask for validation. Read the vote to see its status. Get a vote

{
  "statusCode": 409,
  "message": "Vote already validated",
  "error": "Conflict"
}

Returned by:Validate a vote

How to fix: Wait the number of seconds given in the Retry-After header, then send the call once more. Do not retry in a loop.

{
  "statusCode": 429,
  "message": "Rate limit exceeded"
}

Returned by:Generate an invoices bulk download urlCreate a file generation requestGenerate a fiscal receipts bulk download url