{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
Contributions
Create contribution
Use Idempotency-Key for duplicate-safe retries. The same key and validated input return the existing contribution (201); different input or a deleted original returns 409. Keys are scoped to organization and OAuth application, API key, or unmanaged OAuth user. External IDs alone do not deduplicate split gifts.
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
{
"code": "forbidden",
"message": "You do not have access to this organization.",
"error": "You do not have access to this organization.",
"details": {
"fields": [
{
"field": "amount",
"code": "invalid_type"
}
]
}
}
Authorizations
ApiKeyAuthGrainOAuth2BearerAuth
Authorization
string
header
required
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
X-Organization-Id
string
Required with OAuth access tokens for resource requests. Omit only for GET /api/v1/organizations. Optional with organization API keys; if supplied with an API key, it must match the key's organization.
Idempotency-Key
string
Stable key for one contribution create, retained for the lifetime of the organization. Use a distinct key per split row. Replays return the current representation with current permissions; they do not restore an earlier snapshot.
Required string length: 1 - 200
Pattern: ^[!-~]+$
Body
application/json
amount
number
required
Required range: x > 0
Example:
250
date
string<date>
required
Example:
"2026-07-06"
fundId
string
required
Minimum string length: 1
Example:
"cm789ghi012jkl"
method
enum<string>
required
Available options:
CASH,
CHECK,
CREDIT_CARD,
ACH,
ONLINE,
STOCK,
OTHER
Example:
"CHECK"
donorId
string
Minimum string length: 1
Example:
"cm456def789ghi"
sourceDonorId
string
Minimum string length: 1
checkNumber
string
Required when method is CHECK.
Example:
"1042"
checkDate
string<date> | null
isTaxDeductible
boolean
default:true
notes
string
memo
string | null
Maximum string length: 2000
feeCovered
boolean
givingBatchId
string | null
Minimum string length: 1
settlementId
string | null
Minimum string length: 1
givingMerchantId
string | null
Minimum string length: 1
externalId
string
externalSource
enum<string>
Available options:
PUSHPAY,
PLANNING_CENTER,
CCB,
TITHELY,
SUBSPLASH,
ROCK_RMS,
OVERFLOW,
MANUAL,
OTHER
externalDonorId
string | null
Maximum string length: 500
givingEventKey
string | null
Required string length: 1 - 500
processingFee
number
Required range: x >= 0
netAmount
number
Required range: x >= 0
paymentStatus
enum<string>
Available options:
PENDING,
SUCCEEDED,
FAILED
paymentLast4
string | null
Maximum string length: 4
paymentBrand
string | null
Maximum string length: 100
paymentMethodSub
string | null
Maximum string length: 100
paymentMethodType
string | null
Maximum string length: 100
paymentSource
string | null
Maximum string length: 100
isRefunded
boolean
refundedAt
string<date-time> | null
completedAt
string<date-time> | null
sourceType
enum<string>
Available options:
DIRECT,
DAF,
QCD_IRA,
MATCHING,
FOUNDATION,
ESTATE
benefitDescription
string | null
benefitValue
number | null
Required range: x >= 0
deductibleAmount
number | null
Required range: x >= 0
stockTicker
string | null
stockShares
number | null
Required range: x > 0
stockFmvPerShare
number | null
Required range: x > 0
stockTransferDate
string<date> | null
inKindDescription
string | null
inKindFmv
number | null
Required range: x >= 0
inKindAppraisalDate
string<date> | null
foreignCurrency
string | null
foreignAmount
number | null
exchangeRate
number | null
Response
Created contribution
Contribution detail with one-level resource summaries. Provider metadata and processor billing identity are never returned.
id
string
required
donorId
string | null
required
sourceDonorId
string | null
required
amount
number
required
date
string<date-time>
required
Calendar day represented as a UTC-midnight ISO timestamp.
fundId
string
required
method
enum<string>
required
Available options:
CASH,
CHECK,
CREDIT_CARD,
ACH,
ONLINE,
STOCK,
OTHER
isTaxDeductible
boolean
required
externalSource
string
required
givingBatchId
string | null
required
settlementId
string | null
required
givingMerchantId
string | null
required
processingFee
number | null
required
netAmount
number | null
required
feeCovered
boolean
required
payment
object
required
Hide child attributes
payment.status
enum<string>
required
Available options:
PENDING,
SUCCEEDED,
FAILED
payment.last4
string | null
required
payment.brand
string | null
required
payment.methodSubtype
string | null
required
payment.methodType
string | null
required
payment.source
string | null
required
payment.isRefunded
boolean
required
payment.refundedAt
string<date-time> | null
required
payment.completedAt
string<date-time> | null
required
settlementState
object
required
read-only
Hide child attributes
settlementState.isSettled
boolean
required
settlementState.settlementDate
string<date-time> | null
required
settlementState.settlementBatch
string | null
required
settlementState.isCleared
boolean
required
settlementState.clearedAt
string<date-time> | null
required
sourceType
enum<string> | null
required
Available options:
DIRECT,
DAF,
QCD_IRA,
MATCHING,
FOUNDATION,
ESTATE
quidProQuo
object
required
Hide child attributes
quidProQuo.benefitDescription
string | null
required
quidProQuo.benefitValue
number | null
required
quidProQuo.deductibleAmount
number | null
required
stock
object
required
Hide child attributes
stock.ticker
string | null
required
stock.shares
number | null
required
stock.fairMarketValuePerShare
number | null
required
stock.transferDate
string<date-time> | null
required
inKind
object
required
Hide child attributes
inKind.description
string | null
required
inKind.fairMarketValue
number | null
required
inKind.appraisalDate
string<date-time> | null
required
foreignCurrency
string | null
required
foreignAmount
number | null
required
exchangeRate
number | null
required
donor
object | null
required
Present only with donor identity access.
Hide child attributes
donor.id
string
required
donor.firstName
string | null
required
donor.lastName
string | null
required
donor.organizationName
string | null
required
donor.donorType
string | null
required
sourceDonor
object | null
required
Present only with donor identity access.
Hide child attributes
sourceDonor.id
string
required
sourceDonor.firstName
string | null
required
sourceDonor.lastName
string | null
required
sourceDonor.organizationName
string | null
required
sourceDonor.donorType
string | null
required
fund
object | null
required
Hide child attributes
fund.id
string
required
fund.name
string
required
fund.fundType
string | null
required
batch
object | null
required
Hide child attributes
batch.id
string
required
batch.externalReference
string
required
batch.batchDate
string<date-time>
required
batch.status
string
required
batch.totalGross
number
required
batch.totalFees
number
required
batch.totalNet
number
required
batch.donationCount
integer
required
settlement
object | null
required
Hide child attributes
settlement.id
string
required
settlement.provider
string
required
settlement.externalReference
string | null
required
settlement.estimatedArrivalDate
string<date-time>
required
settlement.status
string
required
settlement.totalNet
number
required
journalEntry
object | null
required
Hide child attributes
journalEntry.id
string
required
journalEntry.entryNumber
string | null
required
journalEntry.referenceNumber
string | null
required
merchant
object | null
required
Hide child attributes
merchant.id
string
required
merchant.name
string
required
merchant.campus
object | null
required
Hide child attributes
merchant.campus.id
string
required
merchant.campus.name
string
required
merchant.dimensionValue
object | null
required
Hide child attributes
merchant.dimensionValue.id
string
required
merchant.dimensionValue.name
string
required
createdAt
string<date-time> | null
required
updatedAt
string<date-time> | null
required
checkNumber
string | null
checkDate
string<date-time> | null
Calendar day represented as a UTC-midnight ISO timestamp.
notes
string | null
memo
string | null
externalId
string | null
externalDonorId
string | null
Provider donor identifier. Null when the caller lacks donor identity access.
givingEventKey
string | null
Required string length: 1 - 500
Last modified on October 10, 2026
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"Grain API","description":"Developer documentation for the Grain church accounting and donor management API.","colors":{"primary":"#03440c","light":"#4A806C","dark":"#3D6B5E"},"logo":{"light":"https://mintcdn.com/grainledger/Jxl-ZANCEY95i3PU/images/grain-wordmark-on-light.svg?fit=max\u0026auto=format\u0026n=Jxl-ZANCEY95i3PU\u0026q=85\u0026s=47f8188964661273a33f4901a311ba81","dark":"https://mintcdn.com/grainledger/Jxl-ZANCEY95i3PU/images/grain-wordmark-on-dark.svg?fit=max\u0026auto=format\u0026n=Jxl-ZANCEY95i3PU\u0026q=85\u0026s=b4689fb4f3c2b42f5e3e251f39b0bf76"},"favicon":"https://mintcdn.com/grainledger/Jxl-ZANCEY95i3PU/images/grain-logomark.svg?fit=max\u0026auto=format\u0026n=Jxl-ZANCEY95i3PU\u0026q=85\u0026s=e53c14afdfadd5aa05ef57a0c8f68985","api":{"openapi":["openapi.json"],"params":{"expanded":"all"},"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","javascript","python"],"prefill":true,"autogenerate":true},"url":"full"},"search":{"prompt":"Search Grain API docs..."},"seo":{"metatags":{"og:site_name":"Grain API Docs","og:image":"https://grainledger.com/og-image.jpg?v=wheat-field-20260908","og:image:width":"1200","og:image:height":"630","twitter:card":"summary_large_image","twitter:image":"https://grainledger.com/og-image.jpg?v=wheat-field-20260908"},"indexing":"navigable"},"fonts":{"heading":{"family":"DM Sans","weight":600},"body":{"family":"DM Sans","weight":400}},"styling":{"codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":false},"integrations":{"posthog":{"apiKey":"phc_nev4txvApsir3qS4dQB5T7JvI46Zl0ZXSQHXpgo6IhD","apiHost":"https://us.i.posthog.com","sessionRecording":false}},"metadata":{"timestamp":true},"navigation":{"global":{"anchors":[{"anchor":"Open app","icon":"https://mintlify.s3.us-west-1.amazonaws.com/grainledger/images/grain-logomark.svg","href":"https://app.grainledger.com"},{"anchor":"Support","icon":"circle-question","href":"https://grainledger.com/support"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"grainledger","hasAudioNarration":false,"actualSubdomain":"grainledger","customDomains":["docs.grainledger.com"],"gitSource":{"type":"github","owner":"grain-ledger","repo":"grain","deployBranch":"main","contentDirectory":"api-docs","isPrivate":true,"mountPath":"","label":"","_id":"6af23ed0ed34cff0851c7334"},"entitlements":{},"buildId":"6aca5e6adf7fb4ef9ef2ce28","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":59},{"language":"default","tag":"Transactions","count":14},{"language":"default","tag":"Getting Started","count":10},{"language":"default","tag":"Households","count":8},{"language":"default","tag":"Core concepts","count":7},{"language":"default","tag":"Bills","count":5},{"language":"default","tag":"Contributions","count":5},{"language":"default","tag":"Donors","count":5},{"language":"default","tag":"Giving Batches","count":5},{"language":"default","tag":"Pledges","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[]}
{"page":{"pagePath":"api-reference/contributions/create-contribution","slug":"/api-reference/contributions/create-contribution","pageMetadata":{"title":"Create contribution","description":"Use Idempotency-Key for duplicate-safe retries. The same key and validated input return the existing contribution (201); different input or a deleted original returns 409. Keys are scoped to organization and OAuth application, API key, or unmanaged OAuth user. External IDs alone do not deduplicate split gifts.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/contributions","href":"/api-reference/contributions/create-contribution","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Use Idempotency-Key for duplicate-safe retries. The same key and validated input return the existing contribution (201); different input or a deleted original returns 409. Keys are scoped to organization and OAuth application, API key, or unmanaged OAuth user. External IDs alone do not deduplicate split gifts.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"title":"Create contribution","description":"Use Idempotency-Key for duplicate-safe retries. The same key and validated input return the existing contribution (201); different input or a deleted original returns 409. Keys are scoped to organization and OAuth application, API key, or unmanaged OAuth user. External IDs alone do not deduplicate split gifts.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/contributions","href":"/api-reference/contributions/create-contribution","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Contributions"],"summary":"Create contribution","description":"Use Idempotency-Key for duplicate-safe retries. The same key and validated input return the existing contribution (201); different input or a deleted original returns 409. Keys are scoped to organization and OAuth application, API key, or unmanaged OAuth user. External IDs alone do not deduplicate split gifts.","parameters":["8457c26a-879d-4caa-8eb7-76de85b22a0e","b0df5dbe-6a62-4a75-96e0-91d4fab3447d"],"requestBody":"94009a15-f2e7-48f6-a1ba-c44a01f82f2b","responses":{"201":"bd1798e4-d291-40a2-b175-2eb85a9f5a66","400":"af6c9d3f-39ee-43cb-8854-6042c52dc54d","401":"c82782a2-dd9d-404a-baeb-1fa53a37d0b0","403":"fde85662-2312-4405-a56d-d3285ffd862e","404":"b6b7e2b4-8731-4900-923a-a4d78ed88f6a","409":"6872702e-9879-4b87-bf70-324ddfbaa74e","422":"f3fdd23a-7fb1-40d1-b3aa-3bd4636f8276","429":"d302c471-ac1d-441b-bc5c-33bb0999c8a6","500":"e06f288b-c178-4e17-a27f-fb0b1253c813"},"method":"post","type":"path","servers":["f6713c7b-79dc-4516-9fa4-b80a2e5b565a"],"security":["b13aa5d4-77e1-4461-944f-0c8c2480e9b6","0a4ca29a-fd5e-40fa-afd3-39cd795826a4","5d65a984-a73a-4263-a6ec-edd6bb054d60"],"path":"/api/v1/contributions","baseUrlOptions":["https://api.grainledger.com"],"title":"Create contribution","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.amount":250,"body.date":"2026-07-06","body.fundId":"cm789ghi012jkl","body.method":"CHECK","body.donorId":"cm456def789ghi","body.checkNumber":"1042"}],"urlDisplay":"full"},"dependencies":{"parameters":{"8457c26a-879d-4caa-8eb7-76de85b22a0e":{"name":"X-Organization-Id","in":"header","required":false,"schema":{"type":"string","isRequired":false,"description":"Required with OAuth access tokens for resource requests. Omit only for GET /api/v1/organizations. Optional with organization API keys; if supplied with an API key, it must match the key's organization.","uniqueKey":"","typeLabel":"string"},"description":"Required with OAuth access tokens for resource requests. Omit only for GET /api/v1/organizations. Optional with organization API keys; if supplied with an API key, it must match the key's organization.","example":"cm123abc456def"},"b0df5dbe-6a62-4a75-96e0-91d4fab3447d":{"name":"Idempotency-Key","in":"header","required":false,"description":"Stable key for one contribution create, retained for the lifetime of the organization. Use a distinct key per split row. Replays return the current representation with current permissions; they do not restore an earlier snapshot.","schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[!-~]+$","isRequired":false,"description":"Stable key for one contribution create, retained for the lifetime of the organization. Use a distinct key per split row. Replays return the current representation with current permissions; they do not restore an earlier snapshot.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["amount","date","fundId","method"],"properties":{"amount":{"type":"number","minimum":0,"exclusiveMinimum":true,"example":250,"isRequired":true,"uniqueKey":"amount","typeLabel":"number"},"date":{"type":"string","format":"date","example":"2026-07-06","isRequired":true,"uniqueKey":"date","typeLabel":"string\u003cdate>"},"fundId":{"type":"string","minLength":1,"example":"cm789ghi012jkl","isRequired":true,"uniqueKey":"fundId","typeLabel":"string"},"method":{"type":"string","enum":["CASH","CHECK","CREDIT_CARD","ACH","ONLINE","STOCK","OTHER"],"example":"CHECK","isRequired":true,"uniqueKey":"method","typeLabel":"enum\u003cstring>"},"donorId":{"type":"string","minLength":1,"example":"cm456def789ghi","uniqueKey":"donorId","typeLabel":"string"},"sourceDonorId":{"type":"string","minLength":1,"uniqueKey":"sourceDonorId","typeLabel":"string"},"checkNumber":{"type":"string","example":"1042","description":"Required when method is CHECK.","uniqueKey":"checkNumber","typeLabel":"string"},"checkDate":{"oneOf":[{"type":"string","format":"date","uniqueKey":"checkDate.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","uniqueKey":"checkDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"checkDate","typeLabel":"string\u003cdate> | null"},"isTaxDeductible":{"type":"boolean","default":true,"uniqueKey":"isTaxDeductible","typeLabel":"boolean"},"notes":{"type":"string","uniqueKey":"notes","typeLabel":"string"},"memo":{"oneOf":[{"type":"string","maxLength":2000,"uniqueKey":"memo.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":2000,"uniqueKey":"memo.oneOf.1","typeLabel":"null"}],"uniqueKey":"memo","typeLabel":"string | null"},"feeCovered":{"type":"boolean","uniqueKey":"feeCovered","typeLabel":"boolean"},"givingBatchId":{"oneOf":[{"type":"string","minLength":1,"uniqueKey":"givingBatchId.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"uniqueKey":"givingBatchId.oneOf.1","typeLabel":"null"}],"uniqueKey":"givingBatchId","typeLabel":"string | null"},"settlementId":{"oneOf":[{"type":"string","minLength":1,"uniqueKey":"settlementId.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"uniqueKey":"settlementId.oneOf.1","typeLabel":"null"}],"uniqueKey":"settlementId","typeLabel":"string | null"},"givingMerchantId":{"oneOf":[{"type":"string","minLength":1,"uniqueKey":"givingMerchantId.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"uniqueKey":"givingMerchantId.oneOf.1","typeLabel":"null"}],"uniqueKey":"givingMerchantId","typeLabel":"string | null"},"externalId":{"type":"string","uniqueKey":"externalId","typeLabel":"string"},"externalSource":{"type":"string","enum":["PUSHPAY","PLANNING_CENTER","CCB","TITHELY","SUBSPLASH","ROCK_RMS","OVERFLOW","MANUAL","OTHER"],"uniqueKey":"externalSource","typeLabel":"enum\u003cstring>"},"externalDonorId":{"oneOf":[{"type":"string","maxLength":500,"uniqueKey":"externalDonorId.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":500,"uniqueKey":"externalDonorId.oneOf.1","typeLabel":"null"}],"uniqueKey":"externalDonorId","typeLabel":"string | null"},"givingEventKey":{"oneOf":[{"type":"string","minLength":1,"maxLength":500,"uniqueKey":"givingEventKey.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"maxLength":500,"uniqueKey":"givingEventKey.oneOf.1","typeLabel":"null"}],"uniqueKey":"givingEventKey","typeLabel":"string | null"},"processingFee":{"type":"number","minimum":0,"uniqueKey":"processingFee","typeLabel":"number"},"netAmount":{"type":"number","minimum":0,"uniqueKey":"netAmount","typeLabel":"number"},"paymentStatus":{"type":"string","enum":["PENDING","SUCCEEDED","FAILED"],"uniqueKey":"paymentStatus","typeLabel":"enum\u003cstring>"},"paymentLast4":{"oneOf":[{"type":"string","maxLength":4,"uniqueKey":"paymentLast4.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":4,"uniqueKey":"paymentLast4.oneOf.1","typeLabel":"null"}],"uniqueKey":"paymentLast4","typeLabel":"string | null"},"paymentBrand":{"oneOf":[{"type":"string","maxLength":100,"uniqueKey":"paymentBrand.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":100,"uniqueKey":"paymentBrand.oneOf.1","typeLabel":"null"}],"uniqueKey":"paymentBrand","typeLabel":"string | null"},"paymentMethodSub":{"oneOf":[{"type":"string","maxLength":100,"uniqueKey":"paymentMethodSub.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":100,"uniqueKey":"paymentMethodSub.oneOf.1","typeLabel":"null"}],"uniqueKey":"paymentMethodSub","typeLabel":"string | null"},"paymentMethodType":{"oneOf":[{"type":"string","maxLength":100,"uniqueKey":"paymentMethodType.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":100,"uniqueKey":"paymentMethodType.oneOf.1","typeLabel":"null"}],"uniqueKey":"paymentMethodType","typeLabel":"string | null"},"paymentSource":{"oneOf":[{"type":"string","maxLength":100,"uniqueKey":"paymentSource.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":100,"uniqueKey":"paymentSource.oneOf.1","typeLabel":"null"}],"uniqueKey":"paymentSource","typeLabel":"string | null"},"isRefunded":{"type":"boolean","uniqueKey":"isRefunded","typeLabel":"boolean"},"refundedAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"refundedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"refundedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"refundedAt","typeLabel":"string\u003cdate-time> | null"},"completedAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"completedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"completedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"completedAt","typeLabel":"string\u003cdate-time> | null"},"sourceType":{"type":"string","enum":["DIRECT","DAF","QCD_IRA","MATCHING","FOUNDATION","ESTATE"],"uniqueKey":"sourceType","typeLabel":"enum\u003cstring>"},"benefitDescription":{"oneOf":[{"type":"string","uniqueKey":"benefitDescription.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"benefitDescription.oneOf.1","typeLabel":"null"}],"uniqueKey":"benefitDescription","typeLabel":"string | null"},"benefitValue":{"oneOf":[{"type":"number","minimum":0,"uniqueKey":"benefitValue.oneOf.0","typeLabel":"number"},{"type":"null","minimum":0,"uniqueKey":"benefitValue.oneOf.1","typeLabel":"null"}],"uniqueKey":"benefitValue","typeLabel":"number | null"},"deductibleAmount":{"oneOf":[{"type":"number","minimum":0,"uniqueKey":"deductibleAmount.oneOf.0","typeLabel":"number"},{"type":"null","minimum":0,"uniqueKey":"deductibleAmount.oneOf.1","typeLabel":"null"}],"uniqueKey":"deductibleAmount","typeLabel":"number | null"},"stockTicker":{"oneOf":[{"type":"string","uniqueKey":"stockTicker.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"stockTicker.oneOf.1","typeLabel":"null"}],"uniqueKey":"stockTicker","typeLabel":"string | null"},"stockShares":{"oneOf":[{"type":"number","minimum":0,"exclusiveMinimum":true,"uniqueKey":"stockShares.oneOf.0","typeLabel":"number"},{"type":"null","minimum":0,"exclusiveMinimum":true,"uniqueKey":"stockShares.oneOf.1","typeLabel":"null"}],"uniqueKey":"stockShares","typeLabel":"number | null"},"stockFmvPerShare":{"oneOf":[{"type":"number","minimum":0,"exclusiveMinimum":true,"uniqueKey":"stockFmvPerShare.oneOf.0","typeLabel":"number"},{"type":"null","minimum":0,"exclusiveMinimum":true,"uniqueKey":"stockFmvPerShare.oneOf.1","typeLabel":"null"}],"uniqueKey":"stockFmvPerShare","typeLabel":"number | null"},"stockTransferDate":{"oneOf":[{"type":"string","format":"date","uniqueKey":"stockTransferDate.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","uniqueKey":"stockTransferDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"stockTransferDate","typeLabel":"string\u003cdate> | null"},"inKindDescription":{"oneOf":[{"type":"string","uniqueKey":"inKindDescription.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"inKindDescription.oneOf.1","typeLabel":"null"}],"uniqueKey":"inKindDescription","typeLabel":"string | null"},"inKindFmv":{"oneOf":[{"type":"number","minimum":0,"uniqueKey":"inKindFmv.oneOf.0","typeLabel":"number"},{"type":"null","minimum":0,"uniqueKey":"inKindFmv.oneOf.1","typeLabel":"null"}],"uniqueKey":"inKindFmv","typeLabel":"number | null"},"inKindAppraisalDate":{"oneOf":[{"type":"string","format":"date","uniqueKey":"inKindAppraisalDate.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","uniqueKey":"inKindAppraisalDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"inKindAppraisalDate","typeLabel":"string\u003cdate> | null"},"foreignCurrency":{"oneOf":[{"type":"string","uniqueKey":"foreignCurrency.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"foreignCurrency.oneOf.1","typeLabel":"null"}],"uniqueKey":"foreignCurrency","typeLabel":"string | null"},"foreignAmount":{"oneOf":[{"type":"number","uniqueKey":"foreignAmount.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"foreignAmount.oneOf.1","typeLabel":"null"}],"uniqueKey":"foreignAmount","typeLabel":"number | null"},"exchangeRate":{"oneOf":[{"type":"number","uniqueKey":"exchangeRate.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"exchangeRate.oneOf.1","typeLabel":"null"}],"uniqueKey":"exchangeRate","typeLabel":"number | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"check":{"title":"check","value":{"donorId":"cm456def789ghi","amount":250,"date":"2026-07-06","fundId":"cm789ghi012jkl","method":"CHECK","checkNumber":"1042"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"bd1798e4-d291-40a2-b175-2eb85a9f5a66":{"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"description":"Created contribution","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"description":"Contribution detail with one-level resource summaries. Provider metadata and processor billing identity are never returned.","required":["id","donorId","sourceDonorId","amount","date","fundId","method","isTaxDeductible","externalSource","givingBatchId","settlementId","givingMerchantId","processingFee","netAmount","feeCovered","payment","settlementState","sourceType","quidProQuo","stock","inKind","foreignCurrency","foreignAmount","exchangeRate","donor","sourceDonor","fund","batch","settlement","journalEntry","merchant","createdAt","updatedAt"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"donorId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"donorId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"donorId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"donorId","typeLabel":"string | null"},"sourceDonorId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"sourceDonorId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"sourceDonorId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sourceDonorId","typeLabel":"string | null"},"amount":{"type":"number","isRequired":true,"uniqueKey":"amount","typeLabel":"number"},"date":{"type":"string","format":"date-time","description":"Calendar day represented as a UTC-midnight ISO timestamp.","isRequired":true,"uniqueKey":"date","typeLabel":"string\u003cdate-time>"},"fundId":{"type":"string","isRequired":true,"uniqueKey":"fundId","typeLabel":"string"},"method":{"type":"string","enum":["CASH","CHECK","CREDIT_CARD","ACH","ONLINE","STOCK","OTHER"],"isRequired":true,"uniqueKey":"method","typeLabel":"enum\u003cstring>"},"isTaxDeductible":{"type":"boolean","isRequired":true,"uniqueKey":"isTaxDeductible","typeLabel":"boolean"},"externalSource":{"type":"string","isRequired":true,"uniqueKey":"externalSource","typeLabel":"string"},"givingBatchId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"givingBatchId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"givingBatchId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"givingBatchId","typeLabel":"string | null"},"settlementId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"settlementId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"settlementId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"settlementId","typeLabel":"string | null"},"givingMerchantId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"givingMerchantId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"givingMerchantId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"givingMerchantId","typeLabel":"string | null"},"processingFee":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"processingFee.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"processingFee.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"processingFee","typeLabel":"number | null"},"netAmount":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"netAmount.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"netAmount.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"netAmount","typeLabel":"number | null"},"feeCovered":{"type":"boolean","isRequired":true,"uniqueKey":"feeCovered","typeLabel":"boolean"},"payment":{"type":"object","additionalProperties":false,"required":["status","last4","brand","methodSubtype","methodType","source","completedAt","isRefunded","refundedAt"],"properties":{"status":{"type":"string","enum":["PENDING","SUCCEEDED","FAILED"],"isRequired":true,"uniqueKey":"payment.status","typeLabel":"enum\u003cstring>"},"last4":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"payment.last4.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"payment.last4.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"payment.last4","typeLabel":"string | null"},"brand":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"payment.brand.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"payment.brand.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"payment.brand","typeLabel":"string | null"},"methodSubtype":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"payment.methodSubtype.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"payment.methodSubtype.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"payment.methodSubtype","typeLabel":"string | null"},"methodType":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"payment.methodType.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"payment.methodType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"payment.methodType","typeLabel":"string | null"},"source":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"payment.source.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"payment.source.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"payment.source","typeLabel":"string | null"},"isRefunded":{"type":"boolean","isRequired":true,"uniqueKey":"payment.isRefunded","typeLabel":"boolean"},"refundedAt":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"payment.refundedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"payment.refundedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"payment.refundedAt","typeLabel":"string\u003cdate-time> | null"},"completedAt":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"payment.completedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"payment.completedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"payment.completedAt","typeLabel":"string\u003cdate-time> | null"}},"isRequired":true,"uniqueKey":"payment","typeLabel":"object"},"settlementState":{"type":"object","additionalProperties":false,"readOnly":true,"required":["isSettled","settlementDate","settlementBatch","isCleared","clearedAt"],"properties":{"isSettled":{"type":"boolean","isRequired":true,"uniqueKey":"settlementState.isSettled","typeLabel":"boolean"},"settlementDate":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"settlementState.settlementDate.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"settlementState.settlementDate.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"settlementState.settlementDate","typeLabel":"string\u003cdate-time> | null"},"settlementBatch":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"settlementState.settlementBatch.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"settlementState.settlementBatch.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"settlementState.settlementBatch","typeLabel":"string | null"},"isCleared":{"type":"boolean","isRequired":true,"uniqueKey":"settlementState.isCleared","typeLabel":"boolean"},"clearedAt":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"settlementState.clearedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"settlementState.clearedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"settlementState.clearedAt","typeLabel":"string\u003cdate-time> | null"}},"isRequired":true,"uniqueKey":"settlementState","typeLabel":"object"},"sourceType":{"oneOf":[{"type":"string","enum":["DIRECT","DAF","QCD_IRA","MATCHING","FOUNDATION","ESTATE"],"isRequired":true,"uniqueKey":"sourceType.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["DIRECT","DAF","QCD_IRA","MATCHING","FOUNDATION","ESTATE"],"isRequired":true,"uniqueKey":"sourceType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sourceType","typeLabel":"enum\u003cstring> | null"},"quidProQuo":{"type":"object","additionalProperties":false,"required":["benefitDescription","benefitValue","deductibleAmount"],"properties":{"benefitDescription":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"quidProQuo.benefitDescription.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"quidProQuo.benefitDescription.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"quidProQuo.benefitDescription","typeLabel":"string | null"},"benefitValue":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"quidProQuo.benefitValue.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"quidProQuo.benefitValue.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"quidProQuo.benefitValue","typeLabel":"number | null"},"deductibleAmount":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"quidProQuo.deductibleAmount.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"quidProQuo.deductibleAmount.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"quidProQuo.deductibleAmount","typeLabel":"number | null"}},"isRequired":true,"uniqueKey":"quidProQuo","typeLabel":"object"},"stock":{"type":"object","additionalProperties":false,"required":["ticker","shares","fairMarketValuePerShare","transferDate"],"properties":{"ticker":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"stock.ticker.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"stock.ticker.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"stock.ticker","typeLabel":"string | null"},"shares":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"stock.shares.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"stock.shares.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"stock.shares","typeLabel":"number | null"},"fairMarketValuePerShare":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"stock.fairMarketValuePerShare.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"stock.fairMarketValuePerShare.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"stock.fairMarketValuePerShare","typeLabel":"number | null"},"transferDate":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"stock.transferDate.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"stock.transferDate.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"stock.transferDate","typeLabel":"string\u003cdate-time> | null"}},"isRequired":true,"uniqueKey":"stock","typeLabel":"object"},"inKind":{"type":"object","additionalProperties":false,"required":["description","fairMarketValue","appraisalDate"],"properties":{"description":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"inKind.description.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"inKind.description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"inKind.description","typeLabel":"string | null"},"fairMarketValue":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"inKind.fairMarketValue.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"inKind.fairMarketValue.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"inKind.fairMarketValue","typeLabel":"number | null"},"appraisalDate":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"inKind.appraisalDate.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"inKind.appraisalDate.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"inKind.appraisalDate","typeLabel":"string\u003cdate-time> | null"}},"isRequired":true,"uniqueKey":"inKind","typeLabel":"object"},"foreignCurrency":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"foreignCurrency.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"foreignCurrency.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"foreignCurrency","typeLabel":"string | null"},"foreignAmount":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"foreignAmount.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"foreignAmount.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"foreignAmount","typeLabel":"number | null"},"exchangeRate":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"exchangeRate.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"exchangeRate.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"exchangeRate","typeLabel":"number | null"},"donor":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","firstName","lastName","organizationName","donorType"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"donor.oneOf.0.id","typeLabel":"string"},"firstName":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"donor.oneOf.0.firstName.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"donor.oneOf.0.firstName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"donor.oneOf.0.firstName","typeLabel":"string | null"},"lastName":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"donor.oneOf.0.lastName.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"donor.oneOf.0.lastName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"donor.oneOf.0.lastName","typeLabel":"string | null"},"organizationName":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"donor.oneOf.0.organizationName.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"donor.oneOf.0.organizationName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"donor.oneOf.0.organizationName","typeLabel":"string | null"},"donorType":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"donor.oneOf.0.donorType.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"donor.oneOf.0.donorType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"donor.oneOf.0.donorType","typeLabel":"string | null"}},"description":"Present only with donor identity access.","isRequired":true,"uniqueKey":"donor.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","firstName","lastName","organizationName","donorType"],"properties":{"id":{"type":"string"},"firstName":{"oneOf":[{"type":"string"},{"type":"null"}]},"lastName":{"oneOf":[{"type":"string"},{"type":"null"}]},"organizationName":{"oneOf":[{"type":"string"},{"type":"null"}]},"donorType":{"oneOf":[{"type":"string"},{"type":"null"}]}},"description":"Present only with donor identity access.","isRequired":true,"uniqueKey":"donor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"donor","typeLabel":"object | null"},"sourceDonor":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","firstName","lastName","organizationName","donorType"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"sourceDonor.oneOf.0.id","typeLabel":"string"},"firstName":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"sourceDonor.oneOf.0.firstName.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"sourceDonor.oneOf.0.firstName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sourceDonor.oneOf.0.firstName","typeLabel":"string | null"},"lastName":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"sourceDonor.oneOf.0.lastName.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"sourceDonor.oneOf.0.lastName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sourceDonor.oneOf.0.lastName","typeLabel":"string | null"},"organizationName":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"sourceDonor.oneOf.0.organizationName.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"sourceDonor.oneOf.0.organizationName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sourceDonor.oneOf.0.organizationName","typeLabel":"string | null"},"donorType":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"sourceDonor.oneOf.0.donorType.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"sourceDonor.oneOf.0.donorType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sourceDonor.oneOf.0.donorType","typeLabel":"string | null"}},"description":"Present only with donor identity access.","isRequired":true,"uniqueKey":"sourceDonor.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","firstName","lastName","organizationName","donorType"],"properties":{"id":{"type":"string"},"firstName":{"oneOf":[{"type":"string"},{"type":"null"}]},"lastName":{"oneOf":[{"type":"string"},{"type":"null"}]},"organizationName":{"oneOf":[{"type":"string"},{"type":"null"}]},"donorType":{"oneOf":[{"type":"string"},{"type":"null"}]}},"description":"Present only with donor identity access.","isRequired":true,"uniqueKey":"sourceDonor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sourceDonor","typeLabel":"object | null"},"fund":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","name","fundType"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"fund.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"fund.oneOf.0.name","typeLabel":"string"},"fundType":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"fund.oneOf.0.fundType.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"fund.oneOf.0.fundType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fund.oneOf.0.fundType","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"fund.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","name","fundType"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"fundType":{"oneOf":[{"type":"string"},{"type":"null"}]}},"isRequired":true,"uniqueKey":"fund.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fund","typeLabel":"object | null"},"batch":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","externalReference","batchDate","status","totalGross","totalFees","totalNet","donationCount"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"batch.oneOf.0.id","typeLabel":"string"},"externalReference":{"type":"string","isRequired":true,"uniqueKey":"batch.oneOf.0.externalReference","typeLabel":"string"},"batchDate":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"batch.oneOf.0.batchDate","typeLabel":"string\u003cdate-time>"},"status":{"type":"string","isRequired":true,"uniqueKey":"batch.oneOf.0.status","typeLabel":"string"},"totalGross":{"type":"number","isRequired":true,"uniqueKey":"batch.oneOf.0.totalGross","typeLabel":"number"},"totalFees":{"type":"number","isRequired":true,"uniqueKey":"batch.oneOf.0.totalFees","typeLabel":"number"},"totalNet":{"type":"number","isRequired":true,"uniqueKey":"batch.oneOf.0.totalNet","typeLabel":"number"},"donationCount":{"type":"integer","isRequired":true,"uniqueKey":"batch.oneOf.0.donationCount","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"batch.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","externalReference","batchDate","status","totalGross","totalFees","totalNet","donationCount"],"properties":{"id":{"type":"string"},"externalReference":{"type":"string"},"batchDate":{"type":"string","format":"date-time"},"status":{"type":"string"},"totalGross":{"type":"number"},"totalFees":{"type":"number"},"totalNet":{"type":"number"},"donationCount":{"type":"integer"}},"isRequired":true,"uniqueKey":"batch.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"batch","typeLabel":"object | null"},"settlement":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","provider","externalReference","estimatedArrivalDate","status","totalNet"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"settlement.oneOf.0.id","typeLabel":"string"},"provider":{"type":"string","isRequired":true,"uniqueKey":"settlement.oneOf.0.provider","typeLabel":"string"},"externalReference":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"settlement.oneOf.0.externalReference.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"settlement.oneOf.0.externalReference.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"settlement.oneOf.0.externalReference","typeLabel":"string | null"},"estimatedArrivalDate":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"settlement.oneOf.0.estimatedArrivalDate","typeLabel":"string\u003cdate-time>"},"status":{"type":"string","isRequired":true,"uniqueKey":"settlement.oneOf.0.status","typeLabel":"string"},"totalNet":{"type":"number","isRequired":true,"uniqueKey":"settlement.oneOf.0.totalNet","typeLabel":"number"}},"isRequired":true,"uniqueKey":"settlement.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","provider","externalReference","estimatedArrivalDate","status","totalNet"],"properties":{"id":{"type":"string"},"provider":{"type":"string"},"externalReference":{"oneOf":[{"type":"string"},{"type":"null"}]},"estimatedArrivalDate":{"type":"string","format":"date-time"},"status":{"type":"string"},"totalNet":{"type":"number"}},"isRequired":true,"uniqueKey":"settlement.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"settlement","typeLabel":"object | null"},"journalEntry":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","entryNumber","referenceNumber"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"journalEntry.oneOf.0.id","typeLabel":"string"},"entryNumber":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"journalEntry.oneOf.0.entryNumber.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"journalEntry.oneOf.0.entryNumber.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"journalEntry.oneOf.0.entryNumber","typeLabel":"string | null"},"referenceNumber":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"journalEntry.oneOf.0.referenceNumber.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"journalEntry.oneOf.0.referenceNumber.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"journalEntry.oneOf.0.referenceNumber","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"journalEntry.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","entryNumber","referenceNumber"],"properties":{"id":{"type":"string"},"entryNumber":{"oneOf":[{"type":"string"},{"type":"null"}]},"referenceNumber":{"oneOf":[{"type":"string"},{"type":"null"}]}},"isRequired":true,"uniqueKey":"journalEntry.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"journalEntry","typeLabel":"object | null"},"merchant":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","name","campus","dimensionValue"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"merchant.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"merchant.oneOf.0.name","typeLabel":"string"},"campus":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","name"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"merchant.oneOf.0.campus.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"merchant.oneOf.0.campus.oneOf.0.name","typeLabel":"string"}},"isRequired":true,"uniqueKey":"merchant.oneOf.0.campus.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"}},"isRequired":true,"uniqueKey":"merchant.oneOf.0.campus.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"merchant.oneOf.0.campus","typeLabel":"object | null"},"dimensionValue":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","name"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"merchant.oneOf.0.dimensionValue.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"merchant.oneOf.0.dimensionValue.oneOf.0.name","typeLabel":"string"}},"isRequired":true,"uniqueKey":"merchant.oneOf.0.dimensionValue.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"}},"isRequired":true,"uniqueKey":"merchant.oneOf.0.dimensionValue.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"merchant.oneOf.0.dimensionValue","typeLabel":"object | null"}},"isRequired":true,"uniqueKey":"merchant.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["id","name","campus","dimensionValue"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"campus":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"}}},{"type":"null","additionalProperties":false,"required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"}}}]},"dimensionValue":{"oneOf":[{"type":"object","additionalProperties":false,"required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"}}},{"type":"null","additionalProperties":false,"required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"}}}]}},"isRequired":true,"uniqueKey":"merchant.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"merchant","typeLabel":"object | null"},"createdAt":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"createdAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"createdAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time> | null"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"updatedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"updatedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time> | null"},"checkNumber":{"oneOf":[{"type":"string","uniqueKey":"checkNumber.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"checkNumber.oneOf.1","typeLabel":"null"}],"uniqueKey":"checkNumber","typeLabel":"string | null"},"checkDate":{"oneOf":[{"type":"string","format":"date-time","description":"Calendar day represented as a UTC-midnight ISO timestamp.","uniqueKey":"checkDate.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Calendar day represented as a UTC-midnight ISO timestamp.","uniqueKey":"checkDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"checkDate","typeLabel":"string\u003cdate-time> | null"},"notes":{"oneOf":[{"type":"string","uniqueKey":"notes.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"notes.oneOf.1","typeLabel":"null"}],"uniqueKey":"notes","typeLabel":"string | null"},"memo":{"oneOf":[{"type":"string","uniqueKey":"memo.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"memo.oneOf.1","typeLabel":"null"}],"uniqueKey":"memo","typeLabel":"string | null"},"externalId":{"oneOf":[{"type":"string","uniqueKey":"externalId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"externalId.oneOf.1","typeLabel":"null"}],"uniqueKey":"externalId","typeLabel":"string | null"},"externalDonorId":{"oneOf":[{"type":"string","description":"Provider donor identifier. Null when the caller lacks donor identity access.","uniqueKey":"externalDonorId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Provider donor identifier. Null when the caller lacks donor identity access.","uniqueKey":"externalDonorId.oneOf.1","typeLabel":"null"}],"uniqueKey":"externalDonorId","typeLabel":"string | null"},"givingEventKey":{"oneOf":[{"type":"string","minLength":1,"maxLength":500,"uniqueKey":"givingEventKey.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"maxLength":500,"uniqueKey":"givingEventKey.oneOf.1","typeLabel":"null"}],"uniqueKey":"givingEventKey","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","donorId":"\u003cstring>","sourceDonorId":"\u003cstring>","amount":123,"date":"2023-11-07T05:31:56Z","fundId":"\u003cstring>","method":"CASH","isTaxDeductible":true,"externalSource":"\u003cstring>","givingBatchId":"\u003cstring>","settlementId":"\u003cstring>","givingMerchantId":"\u003cstring>","processingFee":123,"netAmount":123,"feeCovered":true,"payment":{"status":"PENDING","last4":"\u003cstring>","brand":"\u003cstring>","methodSubtype":"\u003cstring>","methodType":"\u003cstring>","source":"\u003cstring>","isRefunded":true,"refundedAt":"2023-11-07T05:31:56Z","completedAt":"2023-11-07T05:31:56Z"},"settlementState":{"isSettled":true,"settlementDate":"2023-11-07T05:31:56Z","settlementBatch":"\u003cstring>","isCleared":true,"clearedAt":"2023-11-07T05:31:56Z"},"sourceType":"DIRECT","quidProQuo":{"benefitDescription":"\u003cstring>","benefitValue":123,"deductibleAmount":123},"stock":{"ticker":"\u003cstring>","shares":123,"fairMarketValuePerShare":123,"transferDate":"2023-11-07T05:31:56Z"},"inKind":{"description":"\u003cstring>","fairMarketValue":123,"appraisalDate":"2023-11-07T05:31:56Z"},"foreignCurrency":"\u003cstring>","foreignAmount":123,"exchangeRate":123,"donor":{"id":"\u003cstring>","firstName":"\u003cstring>","lastName":"\u003cstring>","organizationName":"\u003cstring>","donorType":"\u003cstring>"},"sourceDonor":{"id":"\u003cstring>","firstName":"\u003cstring>","lastName":"\u003cstring>","organizationName":"\u003cstring>","donorType":"\u003cstring>"},"fund":{"id":"\u003cstring>","name":"\u003cstring>","fundType":"\u003cstring>"},"batch":{"id":"\u003cstring>","externalReference":"\u003cstring>","batchDate":"2023-11-07T05:31:56Z","status":"\u003cstring>","totalGross":123,"totalFees":123,"totalNet":123,"donationCount":123},"settlement":{"id":"\u003cstring>","provider":"\u003cstring>","externalReference":"\u003cstring>","estimatedArrivalDate":"2023-11-07T05:31:56Z","status":"\u003cstring>","totalNet":123},"journalEntry":{"id":"\u003cstring>","entryNumber":"\u003cstring>","referenceNumber":"\u003cstring>"},"merchant":{"id":"\u003cstring>","name":"\u003cstring>","campus":{"id":"\u003cstring>","name":"\u003cstring>"},"dimensionValue":{"id":"\u003cstring>","name":"\u003cstring>"}},"createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","checkNumber":"\u003cstring>","checkDate":"2023-11-07T05:31:56Z","notes":"\u003cstring>","memo":"\u003cstring>","externalId":"\u003cstring>","externalDonorId":"\u003cstring>","givingEventKey":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"af6c9d3f-39ee-43cb-8854-6042c52dc54d":{"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"description":"Bad request (missing header or invalid input)","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"c82782a2-dd9d-404a-baeb-1fa53a37d0b0":{"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"description":"Unauthorized (missing or invalid Bearer token)","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"fde85662-2312-4405-a56d-d3285ffd862e":{"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"description":"Forbidden (no access to organization or action)","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"b6b7e2b4-8731-4900-923a-a4d78ed88f6a":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"exampleType":"generated"},"6872702e-9879-4b87-bf70-324ddfbaa74e":{"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"description":"Conflict (duplicate, cross-resource ownership conflict, concurrent change, or accounting-frozen resource)","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"f3fdd23a-7fb1-40d1-b3aa-3bd4636f8276":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"exampleType":"generated"},"d302c471-ac1d-441b-bc5c-33bb0999c8a6":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"exampleType":"generated"},"e06f288b-c178-4e17-a27f-fb0b1253c813":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","description":"Every error response is valid JSON with this shape. The HTTP status code carries the outcome; `code` is a stable machine-readable form of it.","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","conflict","unprocessable_entity","payload_too_large","rate_limited","internal_server_error"],"example":"forbidden","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"You do not have access to this organization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated alias for `message`. Read `message` instead.","example":"You do not have access to this organization.","uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present for schema validation failures. Contains safe top-level field names and validation codes, never submitted values.","properties":{"fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["field","code"],"properties":{"field":{"type":"string","example":"amount","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].field","typeLabel":"string"},"code":{"type":"string","example":"invalid_type","isRequired":true,"uniqueKey":"details.fields.items.[INDEX].code","typeLabel":"string"}},"uniqueKey":"details.fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details.fields","typeLabel":"object[]"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"You do not have access to this organization.","error":"You do not have access to this organization.","details":{"fields":[{"field":"amount","code":"invalid_type"}]}}}},"exampleType":"generated"}},"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"exampleType":"generated"}},"security":{"b13aa5d4-77e1-4461-944f-0c8c2480e9b6":{"ApiKeyAuth":{"type":"http","scheme":"bearer","bearerFormat":"grain_live_… or grain_test_…","description":"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.","scopes":[],"schemeName":"ApiKeyAuth"}},"0a4ca29a-fd5e-40fa-afd3-39cd795826a4":{"GrainOAuth2":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://auth.grainledger.com/auth/v1/oauth/authorize","tokenUrl":"https://auth.grainledger.com/auth/v1/oauth/token","scopes":{"openid":"OpenID Connect","email":"Email address","profile":"Profile information"}}},"scopes":[],"schemeName":"GrainOAuth2"}},"5d65a984-a73a-4263-a6ec-edd6bb054d60":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"OAuth access token (JWT)","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"f6713c7b-79dc-4516-9fa4-b80a2e5b565a":{"url":"https://api.grainledger.com","description":"API Server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"grain_live_… or grain_test_…","description":"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.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"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.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"},{"schemes":[{"scheme":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://auth.grainledger.com/auth/v1/oauth/authorize","tokenUrl":"https://auth.grainledger.com/auth/v1/oauth/token","scopes":{"openid":"OpenID Connect","email":"Email address","profile":"Profile information"}}},"scopes":[],"schemeName":"GrainOAuth2"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"The access token received from the authorization server in the OAuth 2.0 flow.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"GrainOAuth2","name":"Authorization"}],"title":"GrainOAuth2"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"OAuth access token (JWT)","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"OAuth access token (JWT)","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"grainledger","siteName":"Grain API","title":"Create contribution - Grain API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-10T15:49:06.014Z","originalFileLocation":"api-reference/contributions/create-contribution.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Use Idempotency-Key for duplicate-safe retries. The same key and validated input return the existing contribution (201); different input or a deleted original returns 409. Keys are scoped to organization and OAuth application, API key, or unmanaged OAuth user. External IDs alone do not deduplicate split gifts.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Grain API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create contribution - Grain API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Use Idempotency-Key for duplicate-safe retries. The same key and validated input return the existing contribution (201); different input or a deleted original returns 409. Keys are scoped to organization and OAuth application, API key, or unmanaged OAuth user. External IDs alone do not deduplicate split gifts.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Grain API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.grainledger.com/api-reference/contributions/create-contribution\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://grainledger.com/og-image.jpg?v=wheat-field-20260908\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create contribution - Grain API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Use Idempotency-Key for duplicate-safe retries. The same key and validated input return the existing contribution (201); different input or a deleted original returns 409. Keys are scoped to organization and OAuth application, API key, or unmanaged OAuth user. External IDs alone do not deduplicate split gifts.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://grainledger.com/og-image.jpg?v=wheat-field-20260908\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/grainledger/PJpRtk0ZdVq1mTks/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Grain API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#03440c\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.grainledger.com/api-reference/contributions/create-contribution\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/contributions/create-contribution.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.grainledger.com/#organization\",\"name\":\"Grain API\",\"url\":\"https://docs.grainledger.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/grainledger/Jxl-ZANCEY95i3PU/images/grain-wordmark-on-light.svg?fit=max\u0026auto=format\u0026n=Jxl-ZANCEY95i3PU\u0026q=85\u0026s=47f8188964661273a33f4901a311ba81\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.grainledger.com#website\",\"name\":\"Grain API\",\"url\":\"https://docs.grainledger.com\",\"publisher\":{\"@id\":\"https://docs.grainledger.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.grainledger.com/api-reference/contributions/create-contribution#webpage\",\"url\":\"https://docs.grainledger.com/api-reference/contributions/create-contribution\",\"name\":\"Create contribution\",\"description\":\"Use Idempotency-Key for duplicate-safe retries. The same key and validated input return the existing contribution (201); different input or a deleted original returns 409. Keys are scoped to organization and OAuth application, API key, or unmanaged OAuth user. External IDs alone do not deduplicate split gifts.\",\"dateModified\":\"2026-10-10T15:49:06.014Z\",\"isPartOf\":{\"@id\":\"https://docs.grainledger.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.grainledger.com/api-reference/contributions/create-contribution#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.grainledger.com/api-reference/contributions/create-contribution#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Contributions\",\"item\":\"https://docs.grainledger.com/api-reference/contributions/list-contributions\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create contribution\",\"item\":\"https://docs.grainledger.com/api-reference/contributions/create-contribution\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.grainledger.com/api-reference/contributions/create-contribution#apireference\",\"headline\":\"Create contribution\",\"name\":\"Create contribution\",\"description\":\"Use Idempotency-Key for duplicate-safe retries. The same key and validated input return the existing contribution (201); different input or a deleted original returns 409. Keys are scoped to organization and OAuth application, API key, or unmanaged OAuth user. External IDs alone do not deduplicate split gifts.\",\"url\":\"https://docs.grainledger.com/api-reference/contributions/create-contribution\",\"mainEntityOfPage\":{\"@id\":\"https://docs.grainledger.com/api-reference/contributions/create-contribution#webpage\"},\"image\":\"https://grainledger.com/og-image.jpg?v=wheat-field-20260908\",\"dateModified\":\"2026-10-10T15:49:06.014Z\",\"publisher\":{\"@id\":\"https://docs.grainledger.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.grainledger.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Grain API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Grain API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/contributions/create-contribution.md","siteName":"Grain API","nav":{"global":{"anchors":[{"anchor":"Open app","icon":"https://mintlify.s3.us-west-1.amazonaws.com/grainledger/images/grain-logomark.svg","href":"https://app.grainledger.com"},{"anchor":"Support","icon":"circle-question","href":"https://grainledger.com/support"}]},"tabs":[{"tab":"Getting Started","icon":"rocket","pages":[{"title":"Getting Started","href":"/intro"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Funds","pages":[{"title":"List funds","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/funds","href":"/api-reference/funds/list-funds"}]},{"group":"Coding Reference Data","pages":[{"title":"List accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/accounts","href":"/api-reference/coding-reference-data/list-accounts"},{"title":"List dimensions","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/dimensions","href":"/api-reference/coding-reference-data/list-dimensions"},{"title":"List vendors","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/vendors","href":"/api-reference/coding-reference-data/list-vendors"}]},{"group":"Organizations","pages":[{"title":"List authorized organizations","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/organizations","href":"/api-reference/organizations/list-authorized-organizations"}]},{"group":"Transactions","pages":[{"title":"List transactions","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/transactions","href":"/api-reference/transactions/list-transactions"},{"title":"Create transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/transactions","href":"/api-reference/transactions/create-transaction"},{"title":"Get transaction by ID","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/transactions/{id}","href":"/api-reference/transactions/get-transaction-by-id"},{"title":"Delete transaction","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/transactions/{id}","href":"/api-reference/transactions/delete-transaction"},{"title":"Update transaction","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/transactions/{id}","href":"/api-reference/transactions/update-transaction"},{"title":"Code or split a transaction","deprecated":null,"version":null,"openapi":"/openapi.json put /api/v1/transactions/{id}/coding","href":"/api-reference/transactions/code-or-split-a-transaction"},{"title":"Uncategorize a transaction","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/transactions/{id}/coding","href":"/api-reference/transactions/uncategorize-a-transaction"},{"title":"Set transaction dimensions","deprecated":null,"version":null,"openapi":"/openapi.json put /api/v1/transactions/{id}/dimensions","href":"/api-reference/transactions/set-transaction-dimensions"},{"title":"Approve a transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/transactions/{id}/approve","href":"/api-reference/transactions/approve-a-transaction"},{"title":"Unapprove a transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/transactions/{id}/unapprove","href":"/api-reference/transactions/unapprove-a-transaction"},{"title":"List transaction attachments","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/transactions/{id}/attachments","href":"/api-reference/transactions/list-transaction-attachments"},{"title":"Upload a receipt","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/transactions/{id}/attachments","href":"/api-reference/transactions/upload-a-receipt"},{"title":"Get an attachment download URL","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/transactions/{id}/attachments/{fileId}/download","href":"/api-reference/transactions/get-an-attachment-download-url"},{"title":"Delete an attachment","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/transactions/{id}/attachments/{fileId}","href":"/api-reference/transactions/delete-an-attachment"}]},{"group":"Bills","pages":[{"title":"List bills","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/bills","href":"/api-reference/bills/list-bills"},{"title":"Create bill","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/bills","href":"/api-reference/bills/create-bill"},{"title":"Get bill","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/bills/{id}","href":"/api-reference/bills/get-bill"},{"title":"Delete bill","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/bills/{id}","href":"/api-reference/bills/delete-bill"},{"title":"Update bill","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/bills/{id}","href":"/api-reference/bills/update-bill"}]},{"group":"Donors","pages":[{"title":"List donors","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/donors","href":"/api-reference/donors/list-donors"},{"title":"Create donor","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/donors","href":"/api-reference/donors/create-donor"},{"title":"Get donor","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/donors/{id}","href":"/api-reference/donors/get-donor"},{"title":"Delete donor","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/donors/{id}","href":"/api-reference/donors/delete-donor"},{"title":"Update donor","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/donors/{id}","href":"/api-reference/donors/update-donor"}]},{"group":"Contributions","pages":[{"title":"List contributions","description":null,"deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/contributions","href":"/api-reference/contributions/list-contributions"},{"title":"Create contribution","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/contributions","href":"/api-reference/contributions/create-contribution"},{"title":"Get contribution","description":null,"deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/contributions/{id}","href":"/api-reference/contributions/get-contribution"},{"title":"Delete contribution","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/contributions/{id}","href":"/api-reference/contributions/delete-contribution"},{"title":"Update contribution","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/contributions/{id}","href":"/api-reference/contributions/update-contribution"}]},{"group":"Settlements","pages":[{"title":"List settlements","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/settlements","href":"/api-reference/settlements/list-settlements"},{"title":"Create settlement","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/settlements","href":"/api-reference/settlements/create-settlement"},{"title":"Get settlement","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/settlements/{id}","href":"/api-reference/settlements/get-settlement"},{"title":"Delete settlement","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/settlements/{id}","href":"/api-reference/settlements/delete-settlement"},{"title":"Update settlement","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/settlements/{id}","href":"/api-reference/settlements/update-settlement"}]},{"group":"Giving Batches","pages":[{"title":"List giving batches","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/batches","href":"/api-reference/giving-batches/list-giving-batches"},{"title":"Create giving batch","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/batches","href":"/api-reference/giving-batches/create-giving-batch"},{"title":"Get giving batch","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/batches/{id}","href":"/api-reference/giving-batches/get-giving-batch"},{"title":"Delete giving batch","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/batches/{id}","href":"/api-reference/giving-batches/delete-giving-batch"},{"title":"Update giving batch","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/batches/{id}","href":"/api-reference/giving-batches/update-giving-batch"}]},{"group":"Pledge Card Imports","pages":[{"title":"Import pledge card data for review","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/pledge-card-imports","href":"/api-reference/pledge-card-imports/import-pledge-card-data-for-review"},{"title":"List pledge card import reference data","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/pledge-card-imports/reference-data","href":"/api-reference/pledge-card-imports/list-pledge-card-import-reference-data"}]},{"group":"Pledges","pages":[{"title":"List pledges","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/pledges","href":"/api-reference/pledges/list-pledges"},{"title":"Create pledge","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/pledges","href":"/api-reference/pledges/create-pledge"},{"title":"Get pledge","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/pledges/{id}","href":"/api-reference/pledges/get-pledge"},{"title":"Delete pledge","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/pledges/{id}","href":"/api-reference/pledges/delete-pledge"},{"title":"Update pledge","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/pledges/{id}","href":"/api-reference/pledges/update-pledge"}]},{"group":"Households","pages":[{"title":"List households","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/households","href":"/api-reference/households/list-households"},{"title":"Create household","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/households","href":"/api-reference/households/create-household"},{"title":"Get household","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/households/{id}","href":"/api-reference/households/get-household"},{"title":"Delete household","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/households/{id}","href":"/api-reference/households/delete-household"},{"title":"Update household","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/households/{id}","href":"/api-reference/households/update-household"},{"title":"Add household member","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/households/{id}/members","href":"/api-reference/households/add-household-member"},{"title":"Remove household member","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/households/{id}/members/{donorId}","href":"/api-reference/households/remove-household-member"},{"title":"Update household member","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/households/{id}/members/{donorId}","href":"/api-reference/households/update-household-member"}]}]}]},"basePath":"","title":"Create contribution - Grain API","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}