Create Donor Account

Create a new Donor Account.

This endpoint is intended for DAF providers who want to set up a Donor Account on behalf of a donor before that donor uses DAFpay for the first time. See the DAF-Initiated Setup guide for the most common use of this endpoint.

On creation, the Donor Account is placed in pending status. To make the account immediately usable for grant submissions, follow up with Create Authorization Token and provide the resulting code to the donor — when the donor enters the code in DAFpay, the Donor Account is automatically approved.

Create a new Donor Account. This endpoint is intended for DAF providers who want to set up a Donor Account on behalf of a donor before that donor uses DAFpay for the first time. See the [DAF-Initiated Setup guide](/guides/dafpay/donor-accounts/daf-initiated-setup) for the most common use of this endpoint. On creation, the Donor Account is placed in `pending` status. To make the account immediately usable for grant submissions, follow up with [Create Authorization Token](/api/donor-accounts/create-authorization-token) and provide the resulting code to the donor — when the donor enters the code in DAFpay, the Donor Account is automatically approved.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

The request to create a new Donor Account. Used by DAFs to pre-establish access for a donor before that donor authenticates through DAFpay.

donorobjectRequired

The donor’s identity and profile information. email is required and must match the email the donor will use when authenticating with DAFpay — DAFpay matches incoming verified emails to existing Accounts. Other fields are optional and may be filled in later by the donor during DAFpay profile setup.

The donor's identity and profile information. `email` is required and **must** match the email the donor will use when authenticating with DAFpay — DAFpay matches incoming verified emails to existing Accounts. Other fields are optional and may be filled in later by the donor during DAFpay profile setup.

external_idstringOptional

The DAF’s internal identifier for this Donor Account. Optional but strongly recommended — it allows you to reconcile DAFpay grants with the donor’s record in your own system without an additional update later. Maximum length: 255 characters.

metadatamap from strings to stringsOptional

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

Response headers

X-Request-IdstringOptional

The unique identifier for the request

LocationstringOptional

The URI reference of the created donor account.

Response

Created

idstringRead-only

The unique identifier for this object.

statusenum

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.

donorobject

The donor's identity and profile information.

created_atdatetimeRead-only

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

updated_atdatetimeRead-only

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

external_idstring or nullOptional

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.

approvalobject or nullOptionalRead-only

Details about the approval decision. Present when status is approved; otherwise null.

rejectionobject or nullOptionalRead-only

Details about the rejection decision. Present when status is rejected; otherwise null.

disabledbooleanOptionalRead-onlyDefaults to false

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.

metadatamap from strings to stringsOptional

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

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

500

Internal Server Error