Track a share event
POST
/shares
Records a social-share event for a fundraiser or profile. Authentication is optional — the sharing user is recorded when a session is present, otherwise the row is anonymous.
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)
or
Request Body
application/json
JSON
{
"entity_type": "string",
"entity_id": "string",
"platform": "string"
}
Responses
Share tracked
application/json
JSON
{
"success": true,
"message": "string"
}