Create settlement
Creates a resource record only. It never posts a journal entry, links a bank transaction, or reconciles accounting. contributionIds and givingBatchIds are applied atomically.
Authorizations
Organization API key created in Grain Settings → API. The key determines the organization and is limited to its assigned resource scopes. Write scopes imply the corresponding read scope.
Headers
Required with OAuth access tokens. Optional with organization API keys; if supplied, it must match the key's organization.
Body
x >= 0x >= 0x >= 0x >= 0STRIPE, PUSHPAY, SUBSPLASH, TITHELY, PLANNING_CENTER, ROCK_RMS, RAMP, DIVVY, MANUAL Generated when omitted for a manual settlement.
3PENDING, IN_TRANSIT, DEPOSITED, FAILED, CANCELLED GROSS, NET 1000010000100Response
Created settlement
Recorded settlement values plus independently calculated linked-contribution totals. Accounting and bank-link state are read-only; raw provider metadata, sync diagnostics, accounting details, and fingerprints are excluded.
STRIPE, PUSHPAY, SUBSPLASH, TITHELY, PLANNING_CENTER, ROCK_RMS, RAMP, DIVVY, MANUAL Calendar day represented as a UTC-midnight ISO timestamp.
3PENDING, IN_TRANSIT, DEPOSITED, MATCHED, RECONCILED, FAILED, CANCELLED Calendar day represented as a UTC-midnight ISO timestamp.
GROSS, NET