mailboxIds, or with tagIds, contains and status (no selector means every mailbox in the workspace).ONE_TIME pays per mailbox through the wallet and starts the test after the invoice is paid (reference price USD 2 per mailbox). It fails with 400 if a selected mailbox already has a running test and needs an active base plan.MONTHLY uses plan credits (1 per mailbox), starts at once and charges nothing. It needs enough credits from Purchase Deliverability Test Plan, otherwise 400 with hasCredits: false, and returns 207 if some mailboxes could not be queued.subject and body (HTML) must both be set to use custom content, otherwise a default email is sent. With enableSpintax, {a/b/c} groups are resolved per mailbox.ONE_TIME only, the key owner is charged: a Stripe invoice is settled from wallet credit and any uncovered amount stays due on the hosted invoice at checkoutUrl.curl --location 'https://api.zapmail.ai/api/v3/placement-tests/purchase' \
--header 'x-auth-zapmail;' \
--header 'Content-Type: application/json' \
--data '{
"placementType": "ONE_TIME",
"testName": "October warmup check",
"seedAccounts": [
"google",
"microsoft365"
],
"mailboxIds": [
"a1b2c3d4-5e6f-4071-8a9b-0c1d2e3f4a5b",
"7c9e6f10-2b3a-4c5d-9e8f-1a2b3c4d5e6f"
]
}'{
"status": 200,
"message": "Payment link",
"data": {
"checkoutUrl": "https://invoice.stripe.com/i/acct_1Nx/test_YWNjdF8",
"checkoutSession": false,
"walletUsed": true
}
}