Skip to content

Accept a verified-email beneficiary invitation​

POST
/beneficiary-invitations/{id}/accept

The invitation ID is a routing identifier, never a credential. The authenticated active account must verify its matching email. Atomically resolves the campaign, donation recipient snapshots and held ledger entries to this same person, retaining refund history. Idempotent for the same claimant. Does not transfer money to Stripe or a bank; the existing Connect onboarding and settlement checks still apply. Strict rate limiter and no-store response.

Authorizations​

BearerAuth

In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.

Type
HTTP (bearer)

Parameters​

Path Parameters

id*
Type
string
Required
Format
"uuid"

Responses​

Accepted, or already accepted by this recipient

application/json
JSON
{
"data": {
"fundraiser_id": "string",
"accepted": true
}
}

Playground​

Server
Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI

Built with VitePress