Update an existing donor (full update).

PUT

https://prod-api.raisedonors.com/api/Donor/:id

PUT

/api/Donor/:id

curl -X PUT https://prod-api.raisedonors.com/api/Donor/1 \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "firstName": "Emily",
  "lastName": "Johnson"
}'

{
  "id": 12345,
  "name": "Emily Johnson",
  "title": "Ms.",
  "firstName": "Emily",
  "middleName": "Grace",
  "lastName": "Johnson",
  "suffix": "Jr.",
  "email": "emily.johnson@example.com",
  "phone": "+1-555-123-4567",
  "createdDate": "2023-11-10T09:15:00Z",
  "modifiedDate": "2024-04-20T14:30:00Z",
  "notes": "Preferred contact time: afternoons.",
  "isOrganization": false,
  "organizationName": "Johnson Family Foundation",
  "crmKeyUrls": {},
  "crmKey": "CRM-EMJ-2023",
  "crmSecondKey": "SEC-EMJ-2023",
  "isTestMode": false,
  "isArchived": false,
  "isGDPRDeleted": false,
  "primaryAddress": {
    "address1": "123 Maple Street",
    "address2": "Apt 4B",
    "addressType": 1,
    "addressTypeDisplay": "Home",
    "city": "Springfield",
    "countryString": "USA",
    "donorId": 12345,
    "id": 987,
    "isPrimary": true,
    "postal": "62704",
    "state": "IL"
  },
  "donorAddresses": [
    {
      "address1": "123 Maple Street",
      "address2": "Apt 4B",
      "addressType": 1,
      "addressTypeDisplay": "Home",
      "city": "Springfield",
      "countryString": "USA",
      "donorId": 12345,
      "id": 987,
      "isPrimary": true,
      "postal": "62704",
      "state": "IL"
    }
  ],
  "donorEmailAddresses": [
    {
      "id": 555,
      "donorId": 12345,
      "type": 10,
      "typeDisplay": "Personal Email",
      "value": "emily.johnson@example.com",
      "secondaryValue": "",
      "isPrimary": true,
      "isOptedIn": true,
      "isValid": true,
      "isEmail": true,
      "isPhone": false,
      "isBounced": false,
      "countryCode": "US"
    }
  ],
  "donorPhoneNumbers": [
    {
      "id": 556,
      "donorId": 12345,
      "type": 20,
      "typeDisplay": "Mobile",
      "value": "+1-555-123-4567",
      "secondaryValue": "",
      "isPrimary": true,
      "isOptedIn": true,
      "isValid": true,
      "isEmail": false,
      "isPhone": true,
      "isBounced": false,
      "countryCode": "US"
    }
  ]
}

This endpoint performs a full update of the donor record. All fields in the request will replace existing values. To update only specific fields, use the PATCH endpoint instead.

Authentication

Authorizationstring

JWT Authorization header using the Bearer scheme. Example: “Authorization: Bearer {token}”

Path parameters

idlongRequired

The ID of the donor to update.

Request

The complete donor information to update.

DonorRequestobjectRequired

Represents a donor request.

CreateDonorRequestobjectRequired

Represents a request to create a donor.

Response

idlongOptional

Gets or sets the identifier.

namestring or nullOptional

Gets or sets the name.

titlestring or nullOptional

Gets or sets the title.

firstNamestring or nullOptional

Gets or sets the first name.

middleNamestring or nullOptional

Gets or sets the middle name.

lastNamestring or nullOptional

Gets or sets the last name.

suffixstring or nullOptional

Gets or sets the suffix.

emailstring or nullOptional

Gets or sets the email address.

phonestring or nullOptional

Gets or sets the phone.

createdDatestring or nullOptional

Gets or sets the created date.

modifiedDatestring or nullOptionalRead-only

Gets or sets the modified date.

notesstring or nullOptional

Gets or sets any additional notes.

isOrganizationbooleanOptional

Gets or sets a value indicating whether organization.

organizationNamestring or nullOptional

Gets or sets the organization name.

crmKeyUrlsmap from strings to objects or nullOptional

Gets or sets the CRM URLs by integration type.

crmKeystring or nullOptional

Gets or sets the crmkey.

crmSecondKeystring or nullOptional

Gets or sets the crmsecond key.

isTestModebooleanOptional

Gets or sets a value indicating whether test mode.

isArchivedbooleanOptional

Gets or sets a value indicating whether archived.

isGDPRDeletedbooleanOptional

Gets or sets a value indicating whether gdprdeleted.

primaryAddressobject or nullOptional

Gets or sets the address.

donorAddresseslist of objects or nullOptional

Gets or sets the donor addresses.

donorEmailAddresseslist of objects or nullOptional

Gets or sets the donor email addresses.

donorPhoneNumberslist of objects or nullOptional

Gets or sets the donor phone numbers.

Errors

400

Bad Request Error

404

Not Found Error