Test SMTP
Developer Platform, Sandbox & Key Management
/settings
Test SMTP
createSettingsSends a test email via your saved custom SMTP configuration to the authenticated partner account email. Use this to verify that your email settings are correct before going live. This operation does not accept a request body.
Parameters
This endpoint has no path or query parameters.
Headers
AuthorizationstringRequiredBearer sk_sandbox_<your_key> for sandbox requests.
Idempotency-KeystringheaderRequiredUnique string that makes write calls safe to retry on network failure. Required for money movement, trading, KYC, subscriptions, and webhook creation. Deduplicated for 24 hours -- duplicate keys return the cached response. HTTP 409 if a concurrent request with the same key is still in progress.
Example: dep_user42_1743152580
Response fields
messagestringExample: "Test email sent to dev@acme.com"
Response codes
200SMTP test result.