Skip to main content
API Testing Mode automatically cancels all orders submitted through the API. Use it while developing or validating your integration so you can inspect requests safely without sending real mail.

​
What Testing Mode Does

  • Accepts API orders normally so you can validate your payloads and workflow.
  • Automatically cancels those orders instead of mailing them.
  • Prevents accidental production sends during development.
  • Limits a Radius Search bought through the API or Zapier to 5 records per purchase.
If testing mode is off, you have one hour to cancel an order manually before it moves further into fulfillment.

​
Buying Leads Is Not an Order

Cancellation covers orders. Buying a Radius Search is not an order — the records are charged for at $0.05 each the moment they are bought, and there is nothing to cancel afterwards. Testing mode does not make that free, so it caps the purchase instead. While testing mode is on, a Radius Search bought through the API or Zapier is limited to 5 records per purchase. A larger record_count is refused with a 422 before anything is bought:
The request is refused during validation, so no leads are bought and the account is not charged. Buying a Radius Search from the dashboard is not affected and keeps the full 2,500 record limit.
Five records is enough to see the shape of a real response and wire up your handling. Turn testing mode off when you are ready to buy a full list.

​
When to Use It

Keep testing mode enabled until you have verified:
  • Authentication is working
  • Your recipient payloads are correct
  • Your creative and message fields render as expected
  • Your application is ready to send production mail intentionally

​
How to Enable It

Visit API Settings and turn on API/Zapier Test Mode. Before going live, return to the same page and disable testing mode so real orders can be fulfilled.