Record a donation
Records a gift. Only amount_cents is required. Name the donor with person_id, or with donor_email: an email that matches one of your people (capitals ignored) attributes the gift to them, and one that matches nobody CREATES a person with that email and donor_name. Either way the person is given the donor role if they did not have it, even when the key has no permission on People. Send neither for an anonymous gift. A gift recorded as completed with a donor starts any workflow your organization runs when a donor’s gift lands. Needs write on Fundraising.
Authorizations
Body
Response
The donation, as it was recorded.
Whether this gift is in honor of somebody living or in memory of somebody who has died. A type requires dedication_name, and a name requires a type: both halves are refused on their own, because "in memory of" with nobody named cannot be written on a receipt.
honor, memory, null The value of goods or services the donor received, in whole cents. THREE STATES, NOT TWO: null means nobody has recorded a value and a receipt says nothing either way; 0 means the donor received nothing in return; a number means they received goods or services worth that. Only written when the key is present in the body, so a request about something else never turns one into the other.
x >= 0
