Sign in

v39

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-017897360.9 KB
Donor Accounts

Update Donor Account

Update mutable properties on a Donor Account such as external_id, the nested donor fields, and metadata.

The Donor Account's status is managed automatically through the Authorization Token verification flow and cannot be changed directly via this endpoint.

patch/v1/donor_accounts/{id}

Path parameters

idstring required

The unique id of the Donor Account

Request body

external_idstring

The DAF's internal identifier for this Donor Account. Maximum length: 255 characters.

metadataobject

A map of arbitrary string keys and values to store information about the object.

Example request

{
  "donor": {
    "first_name": "Warren",
    "last_name": "Buffet",
    "phone": "+12125550100"
  },
  "external_id": "ACME-DAF-DONOR-1042"
}

Response

OK

idstring required

The unique identifier for this object.

status'pending' | 'approved' | 'rejected' required

The status of a Donor Account.

  • pending: The Donor Account has been created but the DAF has not yet approved or rejected it.
  • approved: The DAF has verified the donor's identity and Grants from this account can be processed.
  • rejected: The DAF has rejected the Donor Account. Grants from this account will not be processed.
external_idstring nullable

The DAF's internal identifier for this Donor Account. Can be set on creation or via Update Donor Account to link the DAFpay Donor Account to the donor's record in the DAF's own systems.

disabledboolean

Whether this Donor Account is currently disabled. A disabled Donor Account remains approved but cannot submit new Grant Requests — call Enable Donor Account to re-enable it. Disabling is only available for accounts in approved status.

created_atstring date-time required

Time when this object was created. Expressed in RFC 3339 format.

updated_atstring date-time required

Time when this object was last updated. Expressed in RFC 3339 format.

metadataobject

A map of arbitrary string keys and values to store information about the object.

Example response

{
  "id": "donor_account_01jpjenf5q6cawy43yxfcrxhct",
  "status": "pending",
  "donor": {
    "email": "warrenBuffet@example.com",
    "first_name": "Warren",
    "last_name": "Buffet",
    "phone": "+12125550100"
  },
  "external_id": "ACME-DAF-DONOR-1042",
  "approval": {
    "approved_at": "2026-04-02T18:30:00Z",
    "approved_by": "daf:fid_01jpjenf5q6cawy43yxfcrxhct"
  },
  "rejection": {
    "rejected_at": "2026-04-02T18:30:00Z",
    "rejected_by": "daf:fid_01jpjenf5q6cawy43yxfcrxhct",
    "rejection_reason": "Donor could not be located in our records."
  },
  "created_at": "2026-04-01T12:00:00Z",
  "updated_at": "2026-04-02T18:30:00Z"
}