anon_email
API referenceAccount

Set the default recipient

PUT
/account/default-recipient

Set the recipient new aliases forward to when recipient_ids is omitted at creation.

The recipient must belong to the caller; a foreign id is a 404, not a 403, so ids cannot be probed across tenants.

Authorization

CognitoUserPool
headerAuthorizationBearer <token>

Cognito user pool ID token. API Gateway validates the token (identity token: no OAuth scopes are configured on the authorizer) and forwards its claims; the sub claim is the tenant key.

Request Body

application/json
  1. body
recipient_id*string

Recipient to use as the default destination for new aliases.

Response Body

Default recipient updated.

application/json
  1. response
message*string
curl -X PUT "https://example.com/account/default-recipient" \  -H "Content-Type: application/json" \  -d '{    "recipient_id": "string"  }'
{  "message": "default recipient updated"}