{
"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"
}
]
}
}
{
"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.
Body
application/json
firstName
string
required
Example:
"Sarah"
lastName
string
required
Example:
"Johnson"
email
string<email> | null
Example:
"sarah@gracechurch.org"
phone
string | null
Example:
"+15551234567"
address
string | null
city
string | null
state
string | null
zip
string | null
notes
string | null
envelopeNumber
string | null
middleName
string | null
nickname
string | null
title
string | null
suffix
string | null
birthdate
string<date> | null
Calendar day returned as a UTC-midnight ISO timestamp.
anniversary
string<date> | null
Calendar day returned as a UTC-midnight ISO timestamp.
gender
enum<string> | null
Available options:
MALE,
FEMALE,
UNSPECIFIED
isChild
boolean
grade
integer | null
Required range: 1 <= x <= 12
graduationYear
integer | null
Required range: 1900 <= x <= 2200
schoolType
enum<string> | null
Available options:
PUBLIC,
PRIVATE,
HOMESCHOOL,
COLLEGE,
OTHER
membershipStatus
enum<string> | null
Available options:
VISITOR,
REGULAR_ATTENDER,
MEMBER,
INACTIVE,
FORMER
memberSince
string<date> | null
primaryCampusId
string | null
inactivatedAt
string<date-time> | null
photoUrl
string | null
employer
string | null
occupation
string | null
secondaryEmail
string<email> | null
secondaryPhone
string | null
workPhone
string | null
householdRef
string | null
householdId
string | null
householdName
string | null
householdPosition
enum<string> | null
Available options:
PRIMARY,
SPOUSE,
CHILD,
OTHER
preferredContactMethod
enum<string> | null
Available options:
EMAIL,
PHONE,
MAIL
emailOptOut
boolean
mailOptOut
boolean
smsOptOut
boolean
externalIds
object | null
Map keyed by a supported ExternalGivingSource: PUSHPAY, PLANNING_CENTER, CCB, TITHELY, SUBSPLASH, ROCK_RMS, OVERFLOW, MANUAL, or OTHER.
Hide child attributes
externalIds.PUSHPAY
string
Minimum string length: 1
externalIds.PLANNING_CENTER
string
Minimum string length: 1
externalIds.CCB
string
Minimum string length: 1
externalIds.TITHELY
string
Minimum string length: 1
externalIds.SUBSPLASH
string
Minimum string length: 1
externalIds.ROCK_RMS
string
Minimum string length: 1
externalIds.OVERFLOW
string
Minimum string length: 1
externalIds.MANUAL
string
Minimum string length: 1
externalIds.OTHER
string
Minimum string length: 1
donorType
enum<string>
Available options:
INDIVIDUAL,
HOUSEHOLD,
ORGANIZATION,
DAF_CUSTODIAN,
FOUNDATION,
ESTATE
organizationName
string | null
defaultCurrency
string | null
Required string length: 3
Response
Created donor
Stable donor profile. Identity fields are null or masked unless the caller has donor identity access.
id
string
firstName
string | null
lastName
string | null
organizationName
string | null
email
string | null
phone
string | null
donorType
enum<string>
Available options:
INDIVIDUAL,
HOUSEHOLD,
ORGANIZATION,
DAF_CUSTODIAN,
FOUNDATION,
ESTATE
householdRef
string | null
householdName
string | null
householdPosition
enum<string> | null
Available options:
PRIMARY,
SPOUSE,
CHILD,
OTHER
isPrimaryContact
boolean
membershipStatus
enum<string> | null
Available options:
VISITOR,
REGULAR_ATTENDER,
MEMBER,
INACTIVE,
FORMER
isActive
boolean
totalGiving
number
contact
object
Hide child attributes
contact.email
string | null
contact.phone
string | null
contact.secondaryEmail
string | null
contact.secondaryPhone
string | null
contact.workPhone
string | null
contact.preferredMethod
enum<string> | null
Available options:
EMAIL,
PHONE,
MAIL
address
object
Hide child attributes
address.line1
string | null
address.city
string | null
address.state
string | null
address.postalCode
string | null
profile
object
Hide child attributes
profile.middleName
string | null
profile.nickname
string | null
profile.title
string | null
profile.suffix
string | null
profile.birthdate
string<date-time> | null
profile.anniversary
string<date-time> | null
profile.gender
string | null
profile.isChild
boolean
profile.grade
integer | null
profile.graduationYear
integer | null
profile.schoolType
string | null
profile.employer
string | null
profile.occupation
string | null
profile.photoUrl
string | null
membership
object
Hide child attributes
membership.status
string | null
membership.memberSince
string<date-time> | null
membership.primaryCampusId
string | null
membership.inactivatedAt
string<date-time> | null
communicationPreferences
object
Hide child attributes
communicationPreferences.emailOptOut
boolean
communicationPreferences.mailOptOut
boolean
communicationPreferences.smsOptOut
boolean
household
object | null
Hide child attributes
household.id
string
household.name
string
household.primaryContactId
string | null
household.memberCount
integer
envelopeNumber
string | null
defaultCurrency
string | null
notes
string | null
externalIds
object[]
Hide child attributes
externalIds.platform
string
required
externalIds.externalId
string
required
giving
object
Hide child attributes
giving.lifetimeGiving
number
giving.giftCount
integer
giving.averageGift
number
giving.firstGiftDate
string<date-time> | null
giving.lastGiftDate
string<date-time> | null
giving.segment
string | null
createdAt
string<date-time> | null
updatedAt
string<date-time> | null
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":[],"googleFontsInlined":true},"customCss":[]}
{"page":{"pagePath":"api-reference/donors/create-donor","slug":"/api-reference/donors/create-donor","pageMetadata":{"title":"Create donor","description":null,"deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/donors","href":"/api-reference/donors/create-donor","autogeneratedByOpenApi":true},"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 donor","description":null,"deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/donors","href":"/api-reference/donors/create-donor","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Donors"],"summary":"Create donor","parameters":["f75ba9d6-e0ee-462c-acc0-7b36302fa3b6"],"requestBody":"d2abda86-bdc2-4606-8f4b-adb52cde147a","responses":{"201":"152a472d-a7f3-4a64-8333-733b83ad2a69","400":"c283339a-a9cf-4130-b7d0-f2f3cd4307b8","401":"3956f4dd-0125-48b6-b57f-3d23f7dec090","403":"65e8f0c4-cde0-4f84-9b27-e5c794b06432","404":"5fca486b-0a0f-49b5-99ea-d967da45b055","409":"66af0a55-14ff-4d3c-9351-4ce316eba931","422":"5dd361d0-352b-4de1-b5b7-db943b7b790a","429":"46aca406-3eb4-4c80-9a72-6f8754256dcd","500":"0cd9c134-a733-41b1-8062-31b93378cd4f"},"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/donors","baseUrlOptions":["https://api.grainledger.com"],"title":"Create donor","description":"","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.firstName":"Sarah","body.lastName":"Johnson","body.email.oneOf.0":"sarah@gracechurch.org","body.phone.oneOf.0":"+15551234567"}],"urlDisplay":"full"},"dependencies":{"parameters":{"f75ba9d6-e0ee-462c-acc0-7b36302fa3b6":{"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"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["firstName","lastName"],"properties":{"firstName":{"type":"string","example":"Sarah","isRequired":true,"uniqueKey":"firstName","typeLabel":"string"},"lastName":{"type":"string","example":"Johnson","isRequired":true,"uniqueKey":"lastName","typeLabel":"string"},"email":{"oneOf":[{"type":"string","format":"email","example":"sarah@gracechurch.org","uniqueKey":"email.oneOf.0","typeLabel":"string\u003cemail>"},{"type":"null","format":"email","example":"sarah@gracechurch.org","uniqueKey":"email.oneOf.1","typeLabel":"null"}],"uniqueKey":"email","typeLabel":"string\u003cemail> | null"},"phone":{"oneOf":[{"type":"string","example":"+15551234567","uniqueKey":"phone.oneOf.0","typeLabel":"string"},{"type":"null","example":"+15551234567","uniqueKey":"phone.oneOf.1","typeLabel":"null"}],"uniqueKey":"phone","typeLabel":"string | null"},"address":{"oneOf":[{"type":"string","uniqueKey":"address.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"address.oneOf.1","typeLabel":"null"}],"uniqueKey":"address","typeLabel":"string | null"},"city":{"oneOf":[{"type":"string","uniqueKey":"city.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"city.oneOf.1","typeLabel":"null"}],"uniqueKey":"city","typeLabel":"string | null"},"state":{"oneOf":[{"type":"string","uniqueKey":"state.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"state.oneOf.1","typeLabel":"null"}],"uniqueKey":"state","typeLabel":"string | null"},"zip":{"oneOf":[{"type":"string","uniqueKey":"zip.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"zip.oneOf.1","typeLabel":"null"}],"uniqueKey":"zip","typeLabel":"string | null"},"notes":{"oneOf":[{"type":"string","uniqueKey":"notes.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"notes.oneOf.1","typeLabel":"null"}],"uniqueKey":"notes","typeLabel":"string | null"},"envelopeNumber":{"oneOf":[{"type":"string","uniqueKey":"envelopeNumber.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"envelopeNumber.oneOf.1","typeLabel":"null"}],"uniqueKey":"envelopeNumber","typeLabel":"string | null"},"middleName":{"oneOf":[{"type":"string","uniqueKey":"middleName.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"middleName.oneOf.1","typeLabel":"null"}],"uniqueKey":"middleName","typeLabel":"string | null"},"nickname":{"oneOf":[{"type":"string","uniqueKey":"nickname.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"nickname.oneOf.1","typeLabel":"null"}],"uniqueKey":"nickname","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"suffix":{"oneOf":[{"type":"string","uniqueKey":"suffix.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"suffix.oneOf.1","typeLabel":"null"}],"uniqueKey":"suffix","typeLabel":"string | null"},"birthdate":{"oneOf":[{"type":"string","format":"date","description":"Calendar day returned as a UTC-midnight ISO timestamp.","uniqueKey":"birthdate.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"Calendar day returned as a UTC-midnight ISO timestamp.","uniqueKey":"birthdate.oneOf.1","typeLabel":"null"}],"uniqueKey":"birthdate","typeLabel":"string\u003cdate> | null"},"anniversary":{"oneOf":[{"type":"string","format":"date","description":"Calendar day returned as a UTC-midnight ISO timestamp.","uniqueKey":"anniversary.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"Calendar day returned as a UTC-midnight ISO timestamp.","uniqueKey":"anniversary.oneOf.1","typeLabel":"null"}],"uniqueKey":"anniversary","typeLabel":"string\u003cdate> | null"},"gender":{"oneOf":[{"type":"string","enum":["MALE","FEMALE","UNSPECIFIED"],"uniqueKey":"gender.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["MALE","FEMALE","UNSPECIFIED"],"uniqueKey":"gender.oneOf.1","typeLabel":"null"}],"uniqueKey":"gender","typeLabel":"enum\u003cstring> | null"},"isChild":{"type":"boolean","uniqueKey":"isChild","typeLabel":"boolean"},"grade":{"oneOf":[{"type":"integer","minimum":1,"maximum":12,"uniqueKey":"grade.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":1,"maximum":12,"uniqueKey":"grade.oneOf.1","typeLabel":"null"}],"uniqueKey":"grade","typeLabel":"integer | null"},"graduationYear":{"oneOf":[{"type":"integer","minimum":1900,"maximum":2200,"uniqueKey":"graduationYear.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":1900,"maximum":2200,"uniqueKey":"graduationYear.oneOf.1","typeLabel":"null"}],"uniqueKey":"graduationYear","typeLabel":"integer | null"},"schoolType":{"oneOf":[{"type":"string","enum":["PUBLIC","PRIVATE","HOMESCHOOL","COLLEGE","OTHER"],"uniqueKey":"schoolType.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["PUBLIC","PRIVATE","HOMESCHOOL","COLLEGE","OTHER"],"uniqueKey":"schoolType.oneOf.1","typeLabel":"null"}],"uniqueKey":"schoolType","typeLabel":"enum\u003cstring> | null"},"membershipStatus":{"oneOf":[{"type":"string","enum":["VISITOR","REGULAR_ATTENDER","MEMBER","INACTIVE","FORMER"],"uniqueKey":"membershipStatus.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["VISITOR","REGULAR_ATTENDER","MEMBER","INACTIVE","FORMER"],"uniqueKey":"membershipStatus.oneOf.1","typeLabel":"null"}],"uniqueKey":"membershipStatus","typeLabel":"enum\u003cstring> | null"},"memberSince":{"oneOf":[{"type":"string","format":"date","uniqueKey":"memberSince.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","uniqueKey":"memberSince.oneOf.1","typeLabel":"null"}],"uniqueKey":"memberSince","typeLabel":"string\u003cdate> | null"},"primaryCampusId":{"oneOf":[{"type":"string","uniqueKey":"primaryCampusId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"primaryCampusId.oneOf.1","typeLabel":"null"}],"uniqueKey":"primaryCampusId","typeLabel":"string | null"},"inactivatedAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"inactivatedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"inactivatedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"inactivatedAt","typeLabel":"string\u003cdate-time> | null"},"photoUrl":{"oneOf":[{"type":"string","uniqueKey":"photoUrl.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"photoUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"photoUrl","typeLabel":"string | null"},"employer":{"oneOf":[{"type":"string","uniqueKey":"employer.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"employer.oneOf.1","typeLabel":"null"}],"uniqueKey":"employer","typeLabel":"string | null"},"occupation":{"oneOf":[{"type":"string","uniqueKey":"occupation.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"occupation.oneOf.1","typeLabel":"null"}],"uniqueKey":"occupation","typeLabel":"string | null"},"secondaryEmail":{"oneOf":[{"type":"string","format":"email","uniqueKey":"secondaryEmail.oneOf.0","typeLabel":"string\u003cemail>"},{"type":"null","format":"email","uniqueKey":"secondaryEmail.oneOf.1","typeLabel":"null"}],"uniqueKey":"secondaryEmail","typeLabel":"string\u003cemail> | null"},"secondaryPhone":{"oneOf":[{"type":"string","uniqueKey":"secondaryPhone.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"secondaryPhone.oneOf.1","typeLabel":"null"}],"uniqueKey":"secondaryPhone","typeLabel":"string | null"},"workPhone":{"oneOf":[{"type":"string","uniqueKey":"workPhone.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"workPhone.oneOf.1","typeLabel":"null"}],"uniqueKey":"workPhone","typeLabel":"string | null"},"householdRef":{"oneOf":[{"type":"string","uniqueKey":"householdRef.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"householdRef.oneOf.1","typeLabel":"null"}],"uniqueKey":"householdRef","typeLabel":"string | null"},"householdId":{"oneOf":[{"type":"string","uniqueKey":"householdId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"householdId.oneOf.1","typeLabel":"null"}],"uniqueKey":"householdId","typeLabel":"string | null"},"householdName":{"oneOf":[{"type":"string","uniqueKey":"householdName.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"householdName.oneOf.1","typeLabel":"null"}],"uniqueKey":"householdName","typeLabel":"string | null"},"householdPosition":{"oneOf":[{"type":"string","enum":["PRIMARY","SPOUSE","CHILD","OTHER"],"uniqueKey":"householdPosition.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["PRIMARY","SPOUSE","CHILD","OTHER"],"uniqueKey":"householdPosition.oneOf.1","typeLabel":"null"}],"uniqueKey":"householdPosition","typeLabel":"enum\u003cstring> | null"},"preferredContactMethod":{"oneOf":[{"type":"string","enum":["EMAIL","PHONE","MAIL"],"uniqueKey":"preferredContactMethod.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["EMAIL","PHONE","MAIL"],"uniqueKey":"preferredContactMethod.oneOf.1","typeLabel":"null"}],"uniqueKey":"preferredContactMethod","typeLabel":"enum\u003cstring> | null"},"emailOptOut":{"type":"boolean","uniqueKey":"emailOptOut","typeLabel":"boolean"},"mailOptOut":{"type":"boolean","uniqueKey":"mailOptOut","typeLabel":"boolean"},"smsOptOut":{"type":"boolean","uniqueKey":"smsOptOut","typeLabel":"boolean"},"externalIds":{"oneOf":[{"type":"object","description":"Map keyed by a supported ExternalGivingSource: PUSHPAY, PLANNING_CENTER, CCB, TITHELY, SUBSPLASH, ROCK_RMS, OVERFLOW, MANUAL, or OTHER.","additionalProperties":false,"properties":{"PUSHPAY":{"type":"string","minLength":1,"uniqueKey":"externalIds.oneOf.0.PUSHPAY","typeLabel":"string"},"PLANNING_CENTER":{"type":"string","minLength":1,"uniqueKey":"externalIds.oneOf.0.PLANNING_CENTER","typeLabel":"string"},"CCB":{"type":"string","minLength":1,"uniqueKey":"externalIds.oneOf.0.CCB","typeLabel":"string"},"TITHELY":{"type":"string","minLength":1,"uniqueKey":"externalIds.oneOf.0.TITHELY","typeLabel":"string"},"SUBSPLASH":{"type":"string","minLength":1,"uniqueKey":"externalIds.oneOf.0.SUBSPLASH","typeLabel":"string"},"ROCK_RMS":{"type":"string","minLength":1,"uniqueKey":"externalIds.oneOf.0.ROCK_RMS","typeLabel":"string"},"OVERFLOW":{"type":"string","minLength":1,"uniqueKey":"externalIds.oneOf.0.OVERFLOW","typeLabel":"string"},"MANUAL":{"type":"string","minLength":1,"uniqueKey":"externalIds.oneOf.0.MANUAL","typeLabel":"string"},"OTHER":{"type":"string","minLength":1,"uniqueKey":"externalIds.oneOf.0.OTHER","typeLabel":"string"}},"uniqueKey":"externalIds.oneOf.0","typeLabel":"object"},{"type":"null","description":"Map keyed by a supported ExternalGivingSource: PUSHPAY, PLANNING_CENTER, CCB, TITHELY, SUBSPLASH, ROCK_RMS, OVERFLOW, MANUAL, or OTHER.","additionalProperties":false,"properties":{"PUSHPAY":{"type":"string","minLength":1},"PLANNING_CENTER":{"type":"string","minLength":1},"CCB":{"type":"string","minLength":1},"TITHELY":{"type":"string","minLength":1},"SUBSPLASH":{"type":"string","minLength":1},"ROCK_RMS":{"type":"string","minLength":1},"OVERFLOW":{"type":"string","minLength":1},"MANUAL":{"type":"string","minLength":1},"OTHER":{"type":"string","minLength":1}},"uniqueKey":"externalIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"externalIds","typeLabel":"object | null"},"donorType":{"type":"string","enum":["INDIVIDUAL","HOUSEHOLD","ORGANIZATION","DAF_CUSTODIAN","FOUNDATION","ESTATE"],"uniqueKey":"donorType","typeLabel":"enum\u003cstring>"},"organizationName":{"oneOf":[{"type":"string","uniqueKey":"organizationName.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"organizationName.oneOf.1","typeLabel":"null"}],"uniqueKey":"organizationName","typeLabel":"string | null"},"defaultCurrency":{"oneOf":[{"type":"string","minLength":3,"maxLength":3,"uniqueKey":"defaultCurrency.oneOf.0","typeLabel":"string"},{"type":"null","minLength":3,"maxLength":3,"uniqueKey":"defaultCurrency.oneOf.1","typeLabel":"null"}],"uniqueKey":"defaultCurrency","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"individual":{"title":"individual","value":{"firstName":"Sarah","lastName":"Johnson","email":"sarah@gracechurch.org","phone":"+15551234567"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"152a472d-a7f3-4a64-8333-733b83ad2a69":{"headers":{"X-Request-Id":{"description":"Server-generated ID linking this request to API activity and audit records.","schema":{"type":"string","format":"uuid"}}},"description":"Created donor","content":{"application/json":{"schema":{"type":"object","description":"Stable donor profile. Identity fields are null or masked unless the caller has donor identity access.","properties":{"id":{"type":"string","uniqueKey":"id","typeLabel":"string"},"firstName":{"oneOf":[{"type":"string","uniqueKey":"firstName.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"firstName.oneOf.1","typeLabel":"null"}],"uniqueKey":"firstName","typeLabel":"string | null"},"lastName":{"oneOf":[{"type":"string","uniqueKey":"lastName.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"lastName.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastName","typeLabel":"string | null"},"organizationName":{"oneOf":[{"type":"string","uniqueKey":"organizationName.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"organizationName.oneOf.1","typeLabel":"null"}],"uniqueKey":"organizationName","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","uniqueKey":"email.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"email.oneOf.1","typeLabel":"null"}],"uniqueKey":"email","typeLabel":"string | null"},"phone":{"oneOf":[{"type":"string","uniqueKey":"phone.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"phone.oneOf.1","typeLabel":"null"}],"uniqueKey":"phone","typeLabel":"string | null"},"donorType":{"type":"string","enum":["INDIVIDUAL","HOUSEHOLD","ORGANIZATION","DAF_CUSTODIAN","FOUNDATION","ESTATE"],"uniqueKey":"donorType","typeLabel":"enum\u003cstring>"},"householdRef":{"oneOf":[{"type":"string","uniqueKey":"householdRef.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"householdRef.oneOf.1","typeLabel":"null"}],"uniqueKey":"householdRef","typeLabel":"string | null"},"householdName":{"oneOf":[{"type":"string","uniqueKey":"householdName.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"householdName.oneOf.1","typeLabel":"null"}],"uniqueKey":"householdName","typeLabel":"string | null"},"householdPosition":{"oneOf":[{"type":"string","enum":["PRIMARY","SPOUSE","CHILD","OTHER"],"uniqueKey":"householdPosition.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["PRIMARY","SPOUSE","CHILD","OTHER"],"uniqueKey":"householdPosition.oneOf.1","typeLabel":"null"}],"uniqueKey":"householdPosition","typeLabel":"enum\u003cstring> | null"},"isPrimaryContact":{"type":"boolean","uniqueKey":"isPrimaryContact","typeLabel":"boolean"},"membershipStatus":{"oneOf":[{"type":"string","enum":["VISITOR","REGULAR_ATTENDER","MEMBER","INACTIVE","FORMER"],"uniqueKey":"membershipStatus.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["VISITOR","REGULAR_ATTENDER","MEMBER","INACTIVE","FORMER"],"uniqueKey":"membershipStatus.oneOf.1","typeLabel":"null"}],"uniqueKey":"membershipStatus","typeLabel":"enum\u003cstring> | null"},"isActive":{"type":"boolean","uniqueKey":"isActive","typeLabel":"boolean"},"totalGiving":{"type":"number","uniqueKey":"totalGiving","typeLabel":"number"},"contact":{"type":"object","properties":{"email":{"oneOf":[{"type":"string","uniqueKey":"contact.email.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"contact.email.oneOf.1","typeLabel":"null"}],"uniqueKey":"contact.email","typeLabel":"string | null"},"phone":{"oneOf":[{"type":"string","uniqueKey":"contact.phone.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"contact.phone.oneOf.1","typeLabel":"null"}],"uniqueKey":"contact.phone","typeLabel":"string | null"},"secondaryEmail":{"oneOf":[{"type":"string","uniqueKey":"contact.secondaryEmail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"contact.secondaryEmail.oneOf.1","typeLabel":"null"}],"uniqueKey":"contact.secondaryEmail","typeLabel":"string | null"},"secondaryPhone":{"oneOf":[{"type":"string","uniqueKey":"contact.secondaryPhone.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"contact.secondaryPhone.oneOf.1","typeLabel":"null"}],"uniqueKey":"contact.secondaryPhone","typeLabel":"string | null"},"workPhone":{"oneOf":[{"type":"string","uniqueKey":"contact.workPhone.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"contact.workPhone.oneOf.1","typeLabel":"null"}],"uniqueKey":"contact.workPhone","typeLabel":"string | null"},"preferredMethod":{"oneOf":[{"type":"string","enum":["EMAIL","PHONE","MAIL"],"uniqueKey":"contact.preferredMethod.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["EMAIL","PHONE","MAIL"],"uniqueKey":"contact.preferredMethod.oneOf.1","typeLabel":"null"}],"uniqueKey":"contact.preferredMethod","typeLabel":"enum\u003cstring> | null"}},"uniqueKey":"contact","typeLabel":"object"},"address":{"type":"object","properties":{"line1":{"oneOf":[{"type":"string","uniqueKey":"address.line1.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"address.line1.oneOf.1","typeLabel":"null"}],"uniqueKey":"address.line1","typeLabel":"string | null"},"city":{"oneOf":[{"type":"string","uniqueKey":"address.city.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"address.city.oneOf.1","typeLabel":"null"}],"uniqueKey":"address.city","typeLabel":"string | null"},"state":{"oneOf":[{"type":"string","uniqueKey":"address.state.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"address.state.oneOf.1","typeLabel":"null"}],"uniqueKey":"address.state","typeLabel":"string | null"},"postalCode":{"oneOf":[{"type":"string","uniqueKey":"address.postalCode.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"address.postalCode.oneOf.1","typeLabel":"null"}],"uniqueKey":"address.postalCode","typeLabel":"string | null"}},"uniqueKey":"address","typeLabel":"object"},"profile":{"type":"object","additionalProperties":false,"properties":{"middleName":{"oneOf":[{"type":"string","uniqueKey":"profile.middleName.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"profile.middleName.oneOf.1","typeLabel":"null"}],"uniqueKey":"profile.middleName","typeLabel":"string | null"},"nickname":{"oneOf":[{"type":"string","uniqueKey":"profile.nickname.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"profile.nickname.oneOf.1","typeLabel":"null"}],"uniqueKey":"profile.nickname","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"profile.title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"profile.title.oneOf.1","typeLabel":"null"}],"uniqueKey":"profile.title","typeLabel":"string | null"},"suffix":{"oneOf":[{"type":"string","uniqueKey":"profile.suffix.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"profile.suffix.oneOf.1","typeLabel":"null"}],"uniqueKey":"profile.suffix","typeLabel":"string | null"},"birthdate":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"profile.birthdate.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"profile.birthdate.oneOf.1","typeLabel":"null"}],"uniqueKey":"profile.birthdate","typeLabel":"string\u003cdate-time> | null"},"anniversary":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"profile.anniversary.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"profile.anniversary.oneOf.1","typeLabel":"null"}],"uniqueKey":"profile.anniversary","typeLabel":"string\u003cdate-time> | null"},"gender":{"oneOf":[{"type":"string","uniqueKey":"profile.gender.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"profile.gender.oneOf.1","typeLabel":"null"}],"uniqueKey":"profile.gender","typeLabel":"string | null"},"isChild":{"type":"boolean","uniqueKey":"profile.isChild","typeLabel":"boolean"},"grade":{"oneOf":[{"type":"integer","uniqueKey":"profile.grade.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"profile.grade.oneOf.1","typeLabel":"null"}],"uniqueKey":"profile.grade","typeLabel":"integer | null"},"graduationYear":{"oneOf":[{"type":"integer","uniqueKey":"profile.graduationYear.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"profile.graduationYear.oneOf.1","typeLabel":"null"}],"uniqueKey":"profile.graduationYear","typeLabel":"integer | null"},"schoolType":{"oneOf":[{"type":"string","uniqueKey":"profile.schoolType.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"profile.schoolType.oneOf.1","typeLabel":"null"}],"uniqueKey":"profile.schoolType","typeLabel":"string | null"},"employer":{"oneOf":[{"type":"string","uniqueKey":"profile.employer.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"profile.employer.oneOf.1","typeLabel":"null"}],"uniqueKey":"profile.employer","typeLabel":"string | null"},"occupation":{"oneOf":[{"type":"string","uniqueKey":"profile.occupation.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"profile.occupation.oneOf.1","typeLabel":"null"}],"uniqueKey":"profile.occupation","typeLabel":"string | null"},"photoUrl":{"oneOf":[{"type":"string","uniqueKey":"profile.photoUrl.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"profile.photoUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"profile.photoUrl","typeLabel":"string | null"}},"uniqueKey":"profile","typeLabel":"object"},"membership":{"type":"object","additionalProperties":false,"properties":{"status":{"oneOf":[{"type":"string","uniqueKey":"membership.status.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"membership.status.oneOf.1","typeLabel":"null"}],"uniqueKey":"membership.status","typeLabel":"string | null"},"memberSince":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"membership.memberSince.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"membership.memberSince.oneOf.1","typeLabel":"null"}],"uniqueKey":"membership.memberSince","typeLabel":"string\u003cdate-time> | null"},"primaryCampusId":{"oneOf":[{"type":"string","uniqueKey":"membership.primaryCampusId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"membership.primaryCampusId.oneOf.1","typeLabel":"null"}],"uniqueKey":"membership.primaryCampusId","typeLabel":"string | null"},"inactivatedAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"membership.inactivatedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"membership.inactivatedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"membership.inactivatedAt","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"membership","typeLabel":"object"},"communicationPreferences":{"type":"object","properties":{"emailOptOut":{"type":"boolean","uniqueKey":"communicationPreferences.emailOptOut","typeLabel":"boolean"},"mailOptOut":{"type":"boolean","uniqueKey":"communicationPreferences.mailOptOut","typeLabel":"boolean"},"smsOptOut":{"type":"boolean","uniqueKey":"communicationPreferences.smsOptOut","typeLabel":"boolean"}},"uniqueKey":"communicationPreferences","typeLabel":"object"},"household":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","uniqueKey":"household.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","uniqueKey":"household.oneOf.0.name","typeLabel":"string"},"primaryContactId":{"oneOf":[{"type":"string","uniqueKey":"household.oneOf.0.primaryContactId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"household.oneOf.0.primaryContactId.oneOf.1","typeLabel":"null"}],"uniqueKey":"household.oneOf.0.primaryContactId","typeLabel":"string | null"},"memberCount":{"type":"integer","uniqueKey":"household.oneOf.0.memberCount","typeLabel":"integer"}},"uniqueKey":"household.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"},"primaryContactId":{"oneOf":[{"type":"string"},{"type":"null"}]},"memberCount":{"type":"integer"}},"uniqueKey":"household.oneOf.1","typeLabel":"null"}],"uniqueKey":"household","typeLabel":"object | null"},"envelopeNumber":{"oneOf":[{"type":"string","uniqueKey":"envelopeNumber.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"envelopeNumber.oneOf.1","typeLabel":"null"}],"uniqueKey":"envelopeNumber","typeLabel":"string | null"},"defaultCurrency":{"oneOf":[{"type":"string","uniqueKey":"defaultCurrency.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"defaultCurrency.oneOf.1","typeLabel":"null"}],"uniqueKey":"defaultCurrency","typeLabel":"string | null"},"notes":{"oneOf":[{"type":"string","uniqueKey":"notes.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"notes.oneOf.1","typeLabel":"null"}],"uniqueKey":"notes","typeLabel":"string | null"},"externalIds":{"type":"array","items":{"type":"object","required":["platform","externalId"],"properties":{"platform":{"type":"string","isRequired":true,"uniqueKey":"externalIds.items.[INDEX].platform","typeLabel":"string"},"externalId":{"type":"string","isRequired":true,"uniqueKey":"externalIds.items.[INDEX].externalId","typeLabel":"string"}},"uniqueKey":"externalIds.items.[INDEX]","typeLabel":"object"},"uniqueKey":"externalIds","typeLabel":"object[]"},"giving":{"type":"object","properties":{"lifetimeGiving":{"type":"number","uniqueKey":"giving.lifetimeGiving","typeLabel":"number"},"giftCount":{"type":"integer","uniqueKey":"giving.giftCount","typeLabel":"integer"},"averageGift":{"type":"number","uniqueKey":"giving.averageGift","typeLabel":"number"},"firstGiftDate":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"giving.firstGiftDate.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"giving.firstGiftDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"giving.firstGiftDate","typeLabel":"string\u003cdate-time> | null"},"lastGiftDate":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"giving.lastGiftDate.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"giving.lastGiftDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"giving.lastGiftDate","typeLabel":"string\u003cdate-time> | null"},"segment":{"oneOf":[{"type":"string","uniqueKey":"giving.segment.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"giving.segment.oneOf.1","typeLabel":"null"}],"uniqueKey":"giving.segment","typeLabel":"string | null"}},"uniqueKey":"giving","typeLabel":"object"},"createdAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"createdAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"createdAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time> | null"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"updatedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"updatedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","firstName":"\u003cstring>","lastName":"\u003cstring>","organizationName":"\u003cstring>","email":"\u003cstring>","phone":"\u003cstring>","donorType":"INDIVIDUAL","householdRef":"\u003cstring>","householdName":"\u003cstring>","householdPosition":"PRIMARY","isPrimaryContact":true,"membershipStatus":"VISITOR","isActive":true,"totalGiving":123,"contact":{"email":"\u003cstring>","phone":"\u003cstring>","secondaryEmail":"\u003cstring>","secondaryPhone":"\u003cstring>","workPhone":"\u003cstring>","preferredMethod":"EMAIL"},"address":{"line1":"\u003cstring>","city":"\u003cstring>","state":"\u003cstring>","postalCode":"\u003cstring>"},"profile":{"middleName":"\u003cstring>","nickname":"\u003cstring>","title":"\u003cstring>","suffix":"\u003cstring>","birthdate":"2023-11-07T05:31:56Z","anniversary":"2023-11-07T05:31:56Z","gender":"\u003cstring>","isChild":true,"grade":123,"graduationYear":123,"schoolType":"\u003cstring>","employer":"\u003cstring>","occupation":"\u003cstring>","photoUrl":"\u003cstring>"},"membership":{"status":"\u003cstring>","memberSince":"2023-11-07T05:31:56Z","primaryCampusId":"\u003cstring>","inactivatedAt":"2023-11-07T05:31:56Z"},"communicationPreferences":{"emailOptOut":true,"mailOptOut":true,"smsOptOut":true},"household":{"id":"\u003cstring>","name":"\u003cstring>","primaryContactId":"\u003cstring>","memberCount":123},"envelopeNumber":"\u003cstring>","defaultCurrency":"\u003cstring>","notes":"\u003cstring>","externalIds":[{"platform":"\u003cstring>","externalId":"\u003cstring>"}],"giving":{"lifetimeGiving":123,"giftCount":123,"averageGift":123,"firstGiftDate":"2023-11-07T05:31:56Z","lastGiftDate":"2023-11-07T05:31:56Z","segment":"\u003cstring>"},"createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"c283339a-a9cf-4130-b7d0-f2f3cd4307b8":{"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"},"3956f4dd-0125-48b6-b57f-3d23f7dec090":{"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"},"65e8f0c4-cde0-4f84-9b27-e5c794b06432":{"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"},"5fca486b-0a0f-49b5-99ea-d967da45b055":{"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"},"66af0a55-14ff-4d3c-9351-4ce316eba931":{"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"},"5dd361d0-352b-4de1-b5b7-db943b7b790a":{"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"},"46aca406-3eb4-4c80-9a72-6f8754256dcd":{"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"},"0cd9c134-a733-41b1-8062-31b93378cd4f":{"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 donor - Grain API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-10T15:49:05.921Z","originalFileLocation":"api-reference/donors/create-donor.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=\"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 donor - Grain API\">\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/donors/create-donor\">\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 donor - Grain API\">\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/donors/create-donor\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/donors/create-donor.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/donors/create-donor#webpage\",\"url\":\"https://docs.grainledger.com/api-reference/donors/create-donor\",\"name\":\"Create donor\",\"dateModified\":\"2026-10-10T15:49:05.921Z\",\"isPartOf\":{\"@id\":\"https://docs.grainledger.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.grainledger.com/api-reference/donors/create-donor#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.grainledger.com/api-reference/donors/create-donor#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Donors\",\"item\":\"https://docs.grainledger.com/api-reference/donors/list-donors\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create donor\",\"item\":\"https://docs.grainledger.com/api-reference/donors/create-donor\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.grainledger.com/api-reference/donors/create-donor#apireference\",\"headline\":\"Create donor\",\"name\":\"Create donor\",\"url\":\"https://docs.grainledger.com/api-reference/donors/create-donor\",\"mainEntityOfPage\":{\"@id\":\"https://docs.grainledger.com/api-reference/donors/create-donor#webpage\"},\"image\":\"https://grainledger.com/og-image.jpg?v=wheat-field-20260908\",\"dateModified\":\"2026-10-10T15:49:05.921Z\",\"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/donors/create-donor.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","description":null,"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","description":null,"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","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","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 donor - 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"]}