POST/api/v2/users/{userId}/referrals/invitations

Sends or resends an email-bound, expiring referral invitation.

Authentication

Send your API key in the x-api-key header on every request.

Parameters

Request parameters
FieldTypeRequiredDescription
userId (path)integer (int32)Yes

Request body

application/json

Request body fields
FieldTypeRequiredDescription
RecipientEmailstringYes
RecipientNamestringNo

Responses

201 — Created

Response 201 fields
FieldTypeRequiredDescription
Idstring (uuid)Yes
RecipientEmailstringYes
RecipientNamestringYes
RegisteredUserIdunknownYes
SourcestringYes
StatusstringYes
DeliveryStatusstringYes
SendCountunknownYes
CreatedAtstring (date-time)Yes
ExpiresAtstring (date-time)Yes
LastSentAtstring (date-time)Yes
AcceptedAtstring (date-time)Yes

Example request

curl -X POST "https://{base_url}/api/v2/users/{userId}/referrals/invitations" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"RecipientEmail":"…"}'

This page is generated from the live OpenAPI specification and always matches the current API.