Update donor

curl --request PATCH \
  --url https://api.grainledger.com/api/v1/donors/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "<string>",
  "lastName": "<string>",
  "email": "jsmith@example.com",
  "phone": "<string>",
  "address": "<string>",
  "city": "<string>",
  "state": "<string>",
  "zip": "<string>",
  "notes": "<string>",
  "middleName": "<string>",
  "nickname": "<string>",
  "title": "<string>",
  "suffix": "<string>",
  "birthdate": "2023-12-25",
  "anniversary": "2023-12-25",
  "isChild": true,
  "grade": 6,
  "graduationYear": 2050,
  "memberSince": "2023-12-25",
  "primaryCampusId": "<string>",
  "inactivatedAt": "2023-11-07T05:31:56Z",
  "photoUrl": "<string>",
  "employer": "<string>",
  "occupation": "<string>",
  "secondaryEmail": "jsmith@example.com",
  "secondaryPhone": "<string>",
  "workPhone": "<string>",
  "emailOptOut": true,
  "mailOptOut": true,
  "smsOptOut": true,
  "householdRef": "<string>",
  "householdId": "<string>",
  "householdName": "<string>",
  "envelopeNumber": "<string>",
  "organizationName": "<string>",
  "defaultCurrency": "<string>",
  "externalIds": {
    "PUSHPAY": "<string>",
    "PLANNING_CENTER": "<string>",
    "CCB": "<string>",
    "TITHELY": "<string>",
    "SUBSPLASH": "<string>",
    "ROCK_RMS": "<string>",
    "MANUAL": "<string>",
    "OTHER": "<string>"
  }
}
'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    firstName: '<string>',
    lastName: '<string>',
    email: 'jsmith@example.com',
    phone: '<string>',
    address: '<string>',
    city: '<string>',
    state: '<string>',
    zip: '<string>',
    notes: '<string>',
    middleName: '<string>',
    nickname: '<string>',
    title: '<string>',
    suffix: '<string>',
    birthdate: '2023-12-25',
    anniversary: '2023-12-25',
    isChild: true,
    grade: 6,
    graduationYear: 2050,
    memberSince: '2023-12-25',
    primaryCampusId: '<string>',
    inactivatedAt: '2023-11-07T05:31:56Z',
    photoUrl: '<string>',
    employer: '<string>',
    occupation: '<string>',
    secondaryEmail: 'jsmith@example.com',
    secondaryPhone: '<string>',
    workPhone: '<string>',
    emailOptOut: true,
    mailOptOut: true,
    smsOptOut: true,
    householdRef: '<string>',
    householdId: '<string>',
    householdName: '<string>',
    envelopeNumber: '<string>',
    organizationName: '<string>',
    defaultCurrency: '<string>',
    externalIds: {
      PUSHPAY: '<string>',
      PLANNING_CENTER: '<string>',
      CCB: '<string>',
      TITHELY: '<string>',
      SUBSPLASH: '<string>',
      ROCK_RMS: '<string>',
      MANUAL: '<string>',
      OTHER: '<string>'
    }
  })
};

fetch('https://api.grainledger.com/api/v1/donors/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.grainledger.com/api/v1/donors/{id}"

payload = {
    "firstName": "<string>",
    "lastName": "<string>",
    "email": "jsmith@example.com",
    "phone": "<string>",
    "address": "<string>",
    "city": "<string>",
    "state": "<string>",
    "zip": "<string>",
    "notes": "<string>",
    "middleName": "<string>",
    "nickname": "<string>",
    "title": "<string>",
    "suffix": "<string>",
    "birthdate": "2023-12-25",
    "anniversary": "2023-12-25",
    "isChild": True,
    "grade": 6,
    "graduationYear": 2050,
    "memberSince": "2023-12-25",
    "primaryCampusId": "<string>",
    "inactivatedAt": "2023-11-07T05:31:56Z",
    "photoUrl": "<string>",
    "employer": "<string>",
    "occupation": "<string>",
    "secondaryEmail": "jsmith@example.com",
    "secondaryPhone": "<string>",
    "workPhone": "<string>",
    "emailOptOut": True,
    "mailOptOut": True,
    "smsOptOut": True,
    "householdRef": "<string>",
    "householdId": "<string>",
    "householdName": "<string>",
    "envelopeNumber": "<string>",
    "organizationName": "<string>",
    "defaultCurrency": "<string>",
    "externalIds": {
        "PUSHPAY": "<string>",
        "PLANNING_CENTER": "<string>",
        "CCB": "<string>",
        "TITHELY": "<string>",
        "SUBSPLASH": "<string>",
        "ROCK_RMS": "<string>",
        "MANUAL": "<string>",
        "OTHER": "<string>"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

{
  "id": "<string>",
  "firstName": "<string>",
  "lastName": "<string>",
  "organizationName": "<string>",
  "email": "<string>",
  "phone": "<string>",
  "donorType": "INDIVIDUAL",
  "householdRef": "<string>",
  "householdName": "<string>",
  "householdPosition": "PRIMARY",
  "isPrimaryContact": true,
  "membershipStatus": "VISITOR",
  "isActive": true,
  "totalGiving": 123,
  "contact": {
    "email": "<string>",
    "phone": "<string>",
    "secondaryEmail": "<string>",
    "secondaryPhone": "<string>",
    "workPhone": "<string>",
    "preferredMethod": "EMAIL"
  },
  "address": {
    "line1": "<string>",
    "city": "<string>",
    "state": "<string>",
    "postalCode": "<string>"
  },
  "profile": {
    "middleName": "<string>",
    "nickname": "<string>",
    "title": "<string>",
    "suffix": "<string>",
    "birthdate": "2023-11-07T05:31:56Z",
    "anniversary": "2023-11-07T05:31:56Z",
    "gender": "<string>",
    "isChild": true,
    "grade": 123,
    "graduationYear": 123,
    "schoolType": "<string>",
    "employer": "<string>",
    "occupation": "<string>",
    "photoUrl": "<string>"
  },
  "membership": {
    "status": "<string>",
    "memberSince": "2023-11-07T05:31:56Z",
    "primaryCampusId": "<string>",
    "inactivatedAt": "2023-11-07T05:31:56Z"
  },
  "communicationPreferences": {
    "emailOptOut": true,
    "mailOptOut": true,
    "smsOptOut": true
  },
  "household": {
    "id": "<string>",
    "name": "<string>",
    "primaryContactId": "<string>",
    "memberCount": 123
  },
  "envelopeNumber": "<string>",
  "defaultCurrency": "<string>",
  "notes": "<string>",
  "externalIds": [
    {
      "platform": "<string>",
      "externalId": "<string>"
    }
  ],
  "giving": {
    "lifetimeGiving": 123,
    "giftCount": 123,
    "averageGift": 123,
    "firstGiftDate": "2023-11-07T05:31:56Z",
    "lastGiftDate": "2023-11-07T05:31:56Z",
    "segment": "<string>"
  },
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

{
  "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"
      }
    ]
  }
}

PATCH

https://api.grainledger.com

api

donors

{id}

Update donor

curl --request PATCH \
  --url https://api.grainledger.com/api/v1/donors/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "<string>",
  "lastName": "<string>",
  "email": "jsmith@example.com",
  "phone": "<string>",
  "address": "<string>",
  "city": "<string>",
  "state": "<string>",
  "zip": "<string>",
  "notes": "<string>",
  "middleName": "<string>",
  "nickname": "<string>",
  "title": "<string>",
  "suffix": "<string>",
  "birthdate": "2023-12-25",
  "anniversary": "2023-12-25",
  "isChild": true,
  "grade": 6,
  "graduationYear": 2050,
  "memberSince": "2023-12-25",
  "primaryCampusId": "<string>",
  "inactivatedAt": "2023-11-07T05:31:56Z",
  "photoUrl": "<string>",
  "employer": "<string>",
  "occupation": "<string>",
  "secondaryEmail": "jsmith@example.com",
  "secondaryPhone": "<string>",
  "workPhone": "<string>",
  "emailOptOut": true,
  "mailOptOut": true,
  "smsOptOut": true,
  "householdRef": "<string>",
  "householdId": "<string>",
  "householdName": "<string>",
  "envelopeNumber": "<string>",
  "organizationName": "<string>",
  "defaultCurrency": "<string>",
  "externalIds": {
    "PUSHPAY": "<string>",
    "PLANNING_CENTER": "<string>",
    "CCB": "<string>",
    "TITHELY": "<string>",
    "SUBSPLASH": "<string>",
    "ROCK_RMS": "<string>",
    "MANUAL": "<string>",
    "OTHER": "<string>"
  }
}
'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    firstName: '<string>',
    lastName: '<string>',
    email: 'jsmith@example.com',
    phone: '<string>',
    address: '<string>',
    city: '<string>',
    state: '<string>',
    zip: '<string>',
    notes: '<string>',
    middleName: '<string>',
    nickname: '<string>',
    title: '<string>',
    suffix: '<string>',
    birthdate: '2023-12-25',
    anniversary: '2023-12-25',
    isChild: true,
    grade: 6,
    graduationYear: 2050,
    memberSince: '2023-12-25',
    primaryCampusId: '<string>',
    inactivatedAt: '2023-11-07T05:31:56Z',
    photoUrl: '<string>',
    employer: '<string>',
    occupation: '<string>',
    secondaryEmail: 'jsmith@example.com',
    secondaryPhone: '<string>',
    workPhone: '<string>',
    emailOptOut: true,
    mailOptOut: true,
    smsOptOut: true,
    householdRef: '<string>',
    householdId: '<string>',
    householdName: '<string>',
    envelopeNumber: '<string>',
    organizationName: '<string>',
    defaultCurrency: '<string>',
    externalIds: {
      PUSHPAY: '<string>',
      PLANNING_CENTER: '<string>',
      CCB: '<string>',
      TITHELY: '<string>',
      SUBSPLASH: '<string>',
      ROCK_RMS: '<string>',
      MANUAL: '<string>',
      OTHER: '<string>'
    }
  })
};

fetch('https://api.grainledger.com/api/v1/donors/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.grainledger.com/api/v1/donors/{id}"

payload = {
    "firstName": "<string>",
    "lastName": "<string>",
    "email": "jsmith@example.com",
    "phone": "<string>",
    "address": "<string>",
    "city": "<string>",
    "state": "<string>",
    "zip": "<string>",
    "notes": "<string>",
    "middleName": "<string>",
    "nickname": "<string>",
    "title": "<string>",
    "suffix": "<string>",
    "birthdate": "2023-12-25",
    "anniversary": "2023-12-25",
    "isChild": True,
    "grade": 6,
    "graduationYear": 2050,
    "memberSince": "2023-12-25",
    "primaryCampusId": "<string>",
    "inactivatedAt": "2023-11-07T05:31:56Z",
    "photoUrl": "<string>",
    "employer": "<string>",
    "occupation": "<string>",
    "secondaryEmail": "jsmith@example.com",
    "secondaryPhone": "<string>",
    "workPhone": "<string>",
    "emailOptOut": True,
    "mailOptOut": True,
    "smsOptOut": True,
    "householdRef": "<string>",
    "householdId": "<string>",
    "householdName": "<string>",
    "envelopeNumber": "<string>",
    "organizationName": "<string>",
    "defaultCurrency": "<string>",
    "externalIds": {
        "PUSHPAY": "<string>",
        "PLANNING_CENTER": "<string>",
        "CCB": "<string>",
        "TITHELY": "<string>",
        "SUBSPLASH": "<string>",
        "ROCK_RMS": "<string>",
        "MANUAL": "<string>",
        "OTHER": "<string>"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

{
  "id": "<string>",
  "firstName": "<string>",
  "lastName": "<string>",
  "organizationName": "<string>",
  "email": "<string>",
  "phone": "<string>",
  "donorType": "INDIVIDUAL",
  "householdRef": "<string>",
  "householdName": "<string>",
  "householdPosition": "PRIMARY",
  "isPrimaryContact": true,
  "membershipStatus": "VISITOR",
  "isActive": true,
  "totalGiving": 123,
  "contact": {
    "email": "<string>",
    "phone": "<string>",
    "secondaryEmail": "<string>",
    "secondaryPhone": "<string>",
    "workPhone": "<string>",
    "preferredMethod": "EMAIL"
  },
  "address": {
    "line1": "<string>",
    "city": "<string>",
    "state": "<string>",
    "postalCode": "<string>"
  },
  "profile": {
    "middleName": "<string>",
    "nickname": "<string>",
    "title": "<string>",
    "suffix": "<string>",
    "birthdate": "2023-11-07T05:31:56Z",
    "anniversary": "2023-11-07T05:31:56Z",
    "gender": "<string>",
    "isChild": true,
    "grade": 123,
    "graduationYear": 123,
    "schoolType": "<string>",
    "employer": "<string>",
    "occupation": "<string>",
    "photoUrl": "<string>"
  },
  "membership": {
    "status": "<string>",
    "memberSince": "2023-11-07T05:31:56Z",
    "primaryCampusId": "<string>",
    "inactivatedAt": "2023-11-07T05:31:56Z"
  },
  "communicationPreferences": {
    "emailOptOut": true,
    "mailOptOut": true,
    "smsOptOut": true
  },
  "household": {
    "id": "<string>",
    "name": "<string>",
    "primaryContactId": "<string>",
    "memberCount": 123
  },
  "envelopeNumber": "<string>",
  "defaultCurrency": "<string>",
  "notes": "<string>",
  "externalIds": [
    {
      "platform": "<string>",
      "externalId": "<string>"
    }
  ],
  "giving": {
    "lifetimeGiving": 123,
    "giftCount": 123,
    "averageGift": 123,
    "firstGiftDate": "2023-11-07T05:31:56Z",
    "lastGiftDate": "2023-11-07T05:31:56Z",
    "segment": "<string>"
  },
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

{
  "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

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.

Path Parameters

string

required

Resource ID

Body

application/json

All fields are optional. Send null to clear a nullable field.

firstName

string

Minimum string length: 1

lastName

string

Minimum string length: 1

string<email> | null

phone

string | null

address

string | null

city

string | null

state

string | null

zip

string | null

notes

string | null

middleName

string | null

nickname

string | null

title

string | null

suffix

string | null

birthdate

string<date> | null

anniversary

string<date> | null

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

emailOptOut

boolean

mailOptOut

boolean

smsOptOut

boolean

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

envelopeNumber

string | null

donorType

enum<string>

Available options:

INDIVIDUAL,

HOUSEHOLD,

ORGANIZATION,

DAF_CUSTODIAN,

FOUNDATION,

ESTATE

organizationName

string | null

defaultCurrency

string | null

Required string length: 3

externalIds

object | null

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.MANUAL

string

Minimum string length: 1

externalIds.OTHER

string

Minimum string length: 1

Response

Updated donor

Stable donor profile. Identity fields are null or masked unless the caller has donor identity access.

string

firstName

string | null

lastName

string | null

organizationName

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 September 15, 2026

Funds

Organizations

Transactions

Bills

Donors

Contributions

Settlements

Giving Batches

Pledge Card Imports

Pledges

Households

Update donor

Authorizations

Headers

Path Parameters

Body

Response