Send a test of an email
Sends the email as it is now, in one locale, to up to 5 addresses from one of the workspace’s senders, filled in like the preview. The subject is its own, after “[Test]”. Refused before anything is sent when it has gaps in the locale (a subject among them) or the sender can’t send; consent isn’t asked for a test.
Sends the email as it is now, in one locale, to up to 5 addresses from one of the workspace’s senders, filled in like the preview. The subject is its own, after “[Test]”. Refused before anything is sent when it has gaps in the locale (a subject among them) or the sender can’t send; consent isn’t asked for a test.
apiKey writeAuthorizationBearer <token>A workspace API key (pf_…), created under Developers → API keys.
Scope: write
id*string^(email)_[0-9A-Za-z]{8}$idempotency-key?stringRun this write once: a retry with the same key gets the first answer (24 hours).
1 <= length <= 255application/json- body
locale*stringsenderId*stringuuidto*array<>1 <= items <= 5profileId?stringuuideventId?stringuuidCreated
application/json- response
sendId*stringuuidfrom*stringto*array<string>skipped*array<>subject*stringcurl -X POST 'https://api.postforge.dev/v1/emails/string/test-sends' \ -H 'Content-Type: application/json' \ -d '{ "locale": "string", "senderId": "6b2f63ba-164c-48c9-87b1-690cee2b3da3", "to": [ "user@example.com" ]}'{ "sendId": "98079182-77f0-4075-97da-b6e925fc22cb", "from": "string", "to": [ "string" ], "skipped": [ { "address": "string", "reason": "hard_bounce" } ], "subject": "string"}