Skip to main content
POST
Select a global donor account

Body

application/json

Account-selection token and chosen account id from a previous global donor login response.

selection_token
string
required

Short-lived Redis selection token. Validator rule: required|string.

Example:

"8b13d7f4c2e94b5fa0f2a0bb7b9359f469ac943f6bdc1eaaef23b7d75fc2e1ab"

account_id
string
required

Opaque account id returned inside the accounts array. Validator rule: required|string.

Example:

"a8b7c6d5e4f3"

Response

Account selection completed and donor session was created.

status
string
Example:

"success"

message
string
Example:

"You have successfully logged in!"

donor
Donor · object

A donor record. Donors give one-time donations and recurring commitments, and may be linked to entities (recipients) via sponsorships. Standardized profile columns (first_name, phone, address, etc.) coexist with arbitrary custom fields stored in json_fields and defined per hysform_id. The username/email/password columns also let donors sign in to the donor portal.

client
Client · object

A Gratona client — the tenant of the multi-tenant system. Owns donors, entities, programs, users, and integrations. The client_id on every other resource scopes data to this row. Stripe Connect onboarding state, account-level settings, and the client's display name all live here.

program_context
object | null
redirect
string
Example:

"/frontend/donor_view/207/11/7f2c8f8d64b8a1d4a9e2"

session_id
string
Example:

"7f2c8f8d64b8a1d4a9e2"

session_logged_in
boolean
Example:

true