Resubscribe a recipient

POST Stable

/v1/recipients/resubscribe

Use this endpoint only when the recipient has explicitly chosen to receive app notifications again. It writes an audit event and clears the app notification unsubscribe state for the API key environment.

Request

Name	Type	Required	Description	Example
`Authorization`	string	Yes	Bearer API key for the EmailsDone environment.	`Bearer ed_...`
`email`	email	Yes	Recipient email address to resubscribe.	`user@example.com`
`scope`	string	Yes	Subscription scope. V1 supports app notifications.	`app_notifications`

curl

curl -X POST 'https://api.emailsdone.dev/v1/recipients/resubscribe' \
  -H 'Authorization: Bearer ed_...' \
  -H 'Content-Type: application/json' \
  -d '{
  "email": "user@example.com",
  "scope": "app_notifications"
}'

Response

Name	Type	Required	Description	Example
`ok`	boolean	Yes	True when the recipient was marked as resubscribed.	`true`

{
  "ok": true
}

Errors

Status	Code	Message
400	`Invalid resubscribe request.`	Expected a valid email and app_notifications scope.
401	`missing_api_key`	Authorization bearer token is missing.
401	`invalid_api_key`	API key is invalid.
402	`trial_expired`	The trial can no longer send email.
403	`api_key_revoked`	API key has been revoked.
405	`method_not_allowed`	Only POST is allowed.
500	`internal`	Unexpected server error.

Notes

Call this after an explicit user action, not automatically after a bounce or complaint.
The only V1 scope is app_notifications.