Skip to navigation
API ReferenceGifts

Record a gift or pledge.

Gifts may also carry soft credits, which acknowledge someone other than the giver. Send dry_run to validate the request without saving it, and an Idempotency-Key header so a retry cannot record the same gift twice.

Authentication

X-Spring-API-Keystring
Secret API key issued per institution. Send it on every request.

Request

This endpoint expects an object.
donor_idstring or nullRequired

The stored ID of the donor (or donor organization) the gift is attributed to. Required.

amountdouble or nullRequired

Monetary amount. Required for both gifts and pledges and must be greater than zero; a zero amount is allowed only when GiftType is InKind.

subjectstring or nullRequired

Short human-readable title. Required, non-whitespace.

gift_datestring or nullRequired

ISO 8601 date the gift/pledge occurred (e.g. "2026-04-03" or "2026-04-03T10:00:00Z"). Required. Interpreted in the tenant’s time zone and persisted in UTC.

typeenum or nullOptional

gift or pledge. Defaults to gift when omitted. Soft credits are only honored on gifts.

Allowed values:
gift_typeenum or nullOptional

Gift instrument — one of Cash, Check, CreditOrDebit, BankTransfer, StockOrProperty, InKind, PayrollDeduction, Online, Other. Optional; defaults to None. Ignored for pledges.

descriptionstring or nullOptional
fund_idstring or nullOptional

Fund the gift is directed toward. When the tenant has Funds Management enabled the value must match an existing fund’s identifier; otherwise it is stored as a free-form label.

campaign_idstring or nullOptional
The stored ID of a campaign at this institution to attribute the gift to. Optional.
is_completedbooleanOptional

Only meaningful for pledges — marks the pledge fulfilled. Ignored for gifts.

assigned_to_user_idstring or nullOptional
The stored ID of the officer the record is assigned to. Must be a person at this institution when supplied.
soft_creditslist of objects or nullOptional

Up to three soft-credit recipients. Honored on gifts only; ignored for pledges.

Response

Created
objectstring or nullOptionalRead-only

Stripe-style resource discriminator. Stable, snake_case string naming the resource type. Serialized first so it reads as the leading field of every V1 resource body.

idstring or nullOptional

The gift’s or pledge’s stored ID: 9 characters, sent exactly as stored. A dry-run create returns null, because nothing was saved.

donor_idstring or nullOptional
The stored ID of the donor the gift or pledge is attributed to.
typestring or nullOptional
gift_typestring or nullOptional
amountdouble or nullOptional
subjectstring or nullOptional
descriptionstring or nullOptional
fund_idstring or nullOptional
The school's own code for the fund the gift is directed toward, as plain text.
campaign_idstring or nullOptional

The stored ID of the campaign the gift or pledge belongs to, or null.

is_completedbooleanOptional
gift_acknowledgement_sentbooleanOptional
dateintegerOptional
soft_creditslist of objects or nullOptional

Errors

400
Bad Request Error
404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error
429
Too Many Requests Error