Zapmail
latest
  • latest
  • v1
  1. placement test
Zapmail
latest
  • latest
  • v1
  • Zapmail Docs
  • users
    • Retrieve User Details
      GET
  • workspaces
    • Retrieve all workspaces
      GET
    • Create new workspace
      POST
    • Update workspace
      PUT
  • billing
    • Add Billing Details
      POST
    • Update Billing Details
      PUT
  • mailbox
    • Retrieve All Mailboxes
      GET
    • Get Mailbox Details by ID
      GET
    • Assign New Mailboxes to Domains
      POST
    • Update mailbox
      PUT
    • Remove mailboxes on next renewal
      PUT
    • Get Authenticator code
      GET
    • Remove Mailboxes Instantly
      POST
    • Custom OAuth
      POST
  • payments & wallet
    • Add balance to wallet
      POST
    • Get wallet balance
      GET
    • Enable auto recharge
      POST
  • export
    • Export mailboxes
    • Add third party account details
    • Update third party account details
  • subscriptions
    • Get all subscriptions
    • Cancel subscription
    • Upgrade existing subscription
    • Purchase subscription
  • domains
    • Retrieve All Domains
    • List Assignable Domains
    • Add DMARC record
    • Add Domain forwarding
    • Get Name servers to connect domain
    • Verify Name Server Propagation
    • Connect Domain with Zapmail
    • Enable email forwarding
    • Remove email forwarding
    • Enable catch all emails
    • Remove catch all emails
    • Check DNS records
    • Remove unused domains
    • Get available domains for registration
    • Get domains purchase payment link
    • Get domain connection requests
    • Remove domain connection requests
    • Connect Domain with Zapmail (New)
    • Add Google Client ID to Domain
    • Get availability of multiple domain names.
    • Retrieve Domain Health Score
  • dns
    • Get dns records
    • Add dns records
    • Update dns records
    • Delete dns records
  • aged domains
    • Get available domains
    • Purchase aged domains
  • prewarmed domains
    • Get prewarmed domains
    • purchase prewarmed subscription
    • Assign prewarmed mailboxes
  • placement test
    • Get subscriptions
      GET
    • Get Overall Report
      GET
    • Get placement test orders
      GET
    • Get report by cart order id
      GET
    • Get Eligible Mailboxes for Placement Tests
      POST
    • Get Available Placement Test Credits
      GET
    • Purchase Placement Test
      POST
    • Purchase plan
      POST
  • dns shield
    • Get eligible domains
    • Get available slots
    • Get subscriptions
    • Get Allocated Domains for Subscription
    • Allocate Domains to DNS Shield
    • Purchase DNS Shield
    • Upgrade DNS Shield LTD Plan
    • Cancel subscription
  • Schemas
    • domain with filter
  1. placement test

Purchase plan

Testing
POST
/v2/placement-tests/purchase-plan
Purchase a placement test subscription plan (Monthly or LTD). Payment is automatically deducted from your wallet balance.
Monthly plans provide recurring credits each billing cycle. LTD (Lifetime Deal) plans are one-time purchases with monthly credit resets.

Plans#

PlanPriceConcurrent SlotsMax MailboxesTests/MonthCredits/MonthType
Starter$29/month130130Monthly
Growth$99/month21002200Monthly
Pro$199/month2Unlimited2500Monthly
Starter LTD$99130130LTD (One-time)
Growth LTD$29921002200LTD (One-time)
Pro LTD$999220002500LTD (One-time)

Request

Header Params

Body Params application/jsonRequired

Example
{
  "planName": "starter"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.zapmail.ai/api/v2/placement-tests/purchase-plan' \
--header 'x-auth-zapmail;' \
--header 'x-workspace-key;' \
--header 'x-service-provider;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "planName": "starter"
}'

Responses

🟢200Success
application/json
Body

Example
{
  "status": 200,
  "message": "Placement test plan purchased successfully",
  "data": {
    "subscription": {
      "id": "sub_abc123",
      "subscriptionId": "sub_1AbcDefGhiJklMnop",
      "planType": "STARTER",
      "billingCycle": "LTD",
      "lookupKey": "placement_test_starter_ltd",
      "status": "ACTIVE",
      "monthlyCredits": 30,
      "availableCredits": 30,
      "periodStart": "2024-12-15T10:30:00.000Z",
      "periodEnd": "2025-12-15T10:30:00.000Z",
      "price": 99.00,
      "currency": "USD"
    },
    "invoice": {
      "invoiceId": "in_1AbcDefGhiJklMnop",
      "invoiceUrl": "<https://invoice.stripe.com/i/acct_xxx/test_xxx>",
      "amount": 99.00,
      "status": "paid"
    },
    "walletBalance": {
      "previousBalance": 500.00,
      "amountDeducted": 99.00,
      "currentBalance": 401.00
    }
  }
}
Modified at 2025-12-24 13:03:04
Previous
Purchase Placement Test
Next
Get eligible domains
Built with