send_test_site_email

That address is the only one it can reach: it takes no recipient and cannot be pointed anywhere else. It proves that sending works and shows how the sender name and the sending address look once they land in an inbox. The tool tells the client to run it only when you ask for a test, never to check its own work, and never twice for one request.

It goes out through exactly the same path as the site's own mail and shows up in list_site_email_sends marked as a test, but a test is free. It uses none of the site's monthly sends, never buys an extra block, does not count toward the per minute limit, still goes out on a free plan whose 50 included sends are used up, and is left out of get_site_email_stats.

The one limit is 10 seconds between two tests from the same site. A test asked for sooner is refused with 429, a Retry-After header and the wait in the message, for example Wait 7 seconds before sending another test email! It is also refused while sending is off or not available, while the site's own EMAIL_URL or EMAIL_PRIVATE_KEY secret keeps its email off, and when the account's own address, or its domain, is on the site's blocked list.

The answer has the same shape as the one send_site_email gives: the id and the accepted and suppressed recipients, or code and the reason it was refused, and a refusal for the pause between tests or a busy mail provider carries Retry-After. See Send a test email.

Inputs

Input	Type	Required	Description
projectId	string	Yes	The site id.