API reference · Recurring Donations
Update a recurring donation
PATCH/v1/recurring-donations/{recurringDonationId}
Update a recurring donation.
Requires a Bearer access token.
Parameters
This field has no description in the spec.
recurringDonationId#stringin pathrequired
Body
UpdateRecurringDonationDtoamount#integer (int64)minimum 1Donation amount in minor currency unit i.e cents.
donorFirstName#stringFirst name of the donor. Will be used for email communications.
donorLastName#stringLast name of the donor. Will be used for email communications.
donorEmail#stringEmail of the donor. Will be used for email communications.
externalId#stringAn optional internal id of your system e.g orderId or customerId. Can be used to link a recurring donation to an entity in your system.
uniqueExternalId#stringSimilar to externalId but should be unique across all recurring donations. Can be used to prevent duplicate recurring donations.
language#stringLocale to be used to communicate with the donor. Default to the campaign's language value.
fren
Response
200 · RecurringDonationNo field is described in the spec.
recurringDonationId#stringalways returnedtype#RecurringDonationTypealways returnedFREQUENCYMANUALamountType#RecurringDonationAmountTypealways returnedFIXED_AMOUNTRATEstatus#RecurringDonationStatusalways returnedPENDINGACTIVEPAUSEDCANCELEDhasBeenCharged#booleanalways returnedfeeType#FeeTypealways returnedEXCLUDEDINCLUDEDamount#integer (int64)always returnedrate#numberbaseAmount#integer (int64)withRounding#booleanalways returnedfrequency#stringsecret#stringalways returnedexternalId#stringuniqueExternalId#stringsendingMode#CampaignSendingModealways returnedMANUALEMAILPHYSICALSLACKPOSTALsendingDate#string (date-time)sendingStatus#DonationSendingStatusalways returnedPENDINGFAILEDDONElastReminderId#stringmessage#stringreminderMessage#stringfrom#stringlanguage#Languagealways returnedfrenaccountId#stringalways returnedcampaignId#stringalways returnedcharityId#stringdonorId#stringalways returnedcreatedAt#string (date-time)always returnedupdatedAt#string (date-time)always returned
Errors
400A field is missing, has the wrong type, or is not part of the request schema.
Every request with a body or query is validated.
{ "statusCode": 400, "message": [ "amount must not be less than 1", "property foo should not exist" ], "error": "Bad Request" }401Unauthorized
Missing, expired or invalid access token.
{ "statusCode": 401, "message": "Unauthorized" }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" }409Unique constraint failed on uniqueExternalId
{ "statusCode": 409, "message": "Unique constraint failed on uniqueExternalId" }
curl -X PATCH https://api.sandbox.charitips.com/v1/recurring-donations/<recurringDonationId> \ -H "Authorization: Bearer $CHARITIPS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "amount": 2000, "donorFirstName": "<donorFirstName>" }'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.