Create a donor. | AwardSpring API

Creates either an individual or an organization, depending on role. Send dry_run to validate the request without saving it, and an Idempotency-Key header so a retry cannot create the same donor twice.

Authentication

X-Spring-API-Keystring

Secret API key issued per institution. Send it on every request.

Request

This endpoint expects an object.

emailstring or nullOptional

Optional email address — donors may have no email on file, matching the admin UI. When provided it must be a valid email format, 250 characters or fewer, and not already in use by another user in the institution. Note that email-less creates get no duplicate protection from that uniqueness check, so retried requests should carry an Idempotency-Key header to avoid creating the same donor twice.

first_namestring or nullOptional

last_namestring or nullOptional

phonestring or nullOptional

organizationstring or nullOptional

roleenum or nullOptional

Whether this is an individual donor or a donor organization. Defaults to Individual when omitted. Determines which name fields are required.

address1string or nullOptional

address2string or nullOptional

citystring or nullOptional

statestring or nullOptional

countystring or nullOptional

zip_codestring or nullOptional

countryinteger or nullOptional

job_titlestring or nullOptional

work_emailstring or nullOptional

work_phonestring or nullOptional

company_namestring or nullOptional

public_first_namestring or nullOptional

public_last_namestring or nullOptional

public_organization_namestring or nullOptional

websitestring or nullOptional

facebook_urlstring or nullOptional

twitter_urlstring or nullOptional

linked_in_urlstring or nullOptional

descriptionstring or nullOptional

notesstring or nullOptional

make_profile_privateboolean or nullOptional

include_soft_creditsboolean or nullOptional

Response

Created

objectstring or nullOptionalRead-only

Stripe-style resource discriminator. Stable, snake_case string naming the resource type. Serialized first so it reads as the leading field of every V1 resource body.

idintegerOptional

first_namestring or nullOptional

last_namestring or nullOptional

emailstring or nullOptional

phonestring or nullOptional

roleenum or nullOptional

Whether this is an individual donor or a donor organization: Individual or Organization. Mirrors the role field on the create request.

date_of_birthinteger or nullOptional

birth_monthstring or nullOptional

birth_dayinteger or nullOptional

birth_yearinteger or nullOptional