Log inStart creating →
DEVELOPER INFRASTRUCTURE

Email account provisioning, built into your workflow.

Use one API contract to request accounts across multiple providers, inspect progress by task ID, and retrieve reconciled results.

Create accountsSee how it works
✓ Failed items use zero credits  ·  No subscription
CREATE TASK
ProviderGmail
Quantity100 accounts
Estimated total100 credits
Failed? Credits returned.
THE SHORT VERSION

A small surface area for a complicated process: create a task, store its ID, poll its explicit state, and retrieve the final result.

AuthenticationAPI keys

Separate live and test environments

Task updatesPolling

Explicit state retrieval by task ID

Response formatJSON

Consistent across providers

100%credit-back guarantee

Successful accounts consume credits. Failed accounts do not. Any credits reserved for a failed item return to your MailMaker balance automatically.

Read the guarantee →
01 · PREDICTABLE REQUESTS

One task model from request to result.

A creation request identifies the provider and quantity. MailMaker returns a stable task ID with the estimated credit cost and current status. Your application can persist that ID instead of trying to mirror provider-specific execution details.

Statuses move through a small lifecycle: queued, processing, completed, partial, or failed. Final responses separate requested, successful, and failed counts so your application can reconcile results and credits directly.

  • Idempotency keys for safe retries
  • Explicit provider and quantity validation
  • Task-level progress and result retrieval
  • Clear successful and failed account counts
02 · BOUNDED STATUS POLLING

Poll deliberately instead of guessing when a task is done.

Store the task ID returned at creation and retrieve it at a bounded interval. Increase the delay while work remains queued or processing, add jitter for concurrent workers, and stop when the state becomes completed, partial, or failed.

Persist the next-check time and last known state so a worker restart does not create a tight loop. Retrieve and reconcile the final result once rather than repeatedly downloading credential output.

03 · SCOPE AND FIT

Know when this workflow is the right operating model.

The API is designed for asynchronous task orchestration: validate a request, create one durable task, observe explicit state through bounded polling, and retrieve the authoritative final result. It is not a synchronous endpoint that should remain open until every account completes.

Write the intended use, owner, expected quantity, provider choice, result destination, and retention period before execution. A visible scope prevents convenience from turning into ungoverned volume.

  • API-key scope
  • Idempotency ownership
  • State mapping
  • Polling interval and deadline
  • Retry and manual recovery policy
04 · CREDIT-BACK GUARANTEE

Failed items are never converted into paid output.

MailMaker charges credits only for successfully completed accounts. Every item a task reports as failed consumes zero credits; if a reservation was placed while processing, those credits return to the workspace balance automatically.

The guarantee covers the MailMaker creation charge, including partial tasks. It does not promise permanent third-party account availability or remove the customer's responsibility to follow provider rules and secure the results.

  • Successful result: charged at the provider rate
  • Failed result: zero credits
  • Reserved credit for failure: returned automatically
  • Partial task: successful portion only
05 · WORKED EXAMPLE

Translate the product into a reviewable operating sequence.

An internal portal accepts an approved account request, creates an idempotency key, stores it with the internal job, submits the MailMaker task, and returns immediately. A worker retrieves the task on a backoff schedule until it reaches a terminal state, then reconciles the result.

The pattern is consistent: validate with the real configuration, retain the task ID, compare requested and completed counts, confirm actual credit usage, and obtain acceptance from the result owner before repeating or expanding the work.

06 · FAILURE AND RECOVERY

Decide how the workflow stops before something fails.

The largest integration risks are duplicate creation after a timeout, overly aggressive polling, never-ending status checks, stale local state, and allowing raw credentials into logs. Each risk needs a control before production volume is enabled.

Validation errors should be corrected before resubmission. Network uncertainty should be recovered with the original idempotency key. Partial completion requires reconciliation, while permanent or policy-related failure should stop the workflow and reach the named owner.

  • Reject invalid or unowned requests
  • Bound retries and use backoff
  • Recover uncertain tasks instead of duplicating them
  • Separate usable partial output from failures
  • Keep a manual stop and escalation path
07 · MEASUREMENT

Measure explainable output instead of button clicks.

Monitor request validation failures, idempotent replays, polling frequency, tasks exceeding maximum age, partial completion, reconciliation mismatches, and manual-review queue time.

Attach measurements to the source task and internal request. Aggregate reporting should be derived from those records so a headline total cannot hide provider differences, partial results, duplicate attempts, or unresolved credential handling.

  • Requested versus successful
  • Estimated versus actual credits
  • Processing and reconciliation duration
  • Replacement task volume
  • Security and retention exceptions
08 · EVALUATION QUESTIONS

Questions to answer before choosing or scaling the product.

Ask whether the supported providers match the actual requirement, how pricing changes with provider mix, which task states are visible, how partial results are represented, where exports are stored, and what happens after an uncertain network request. For API use, also ask how keys are scoped, polling is bounded, terminal states stop the worker, and final results are retrieved.

The answers should be concrete enough to become acceptance criteria. If the team cannot define a successful result, an acceptable failure path, a budget ceiling, and a result owner, increasing volume will amplify ambiguity rather than create operational efficiency.

  • Does provider coverage match the use case?
  • Can cost be estimated before submission?
  • Are partial results visible?
  • Can retries avoid duplicate tasks?
  • Who controls and removes the output?
09 · READINESS CHECKLIST

Review the complete lifecycle before production use.

Confirm authorization, scope, provider, quantity, budget, owner, execution method, status handling, result destination, and deletion plan. If the workflow uses an API, also verify key scope, idempotency, bounded polling, bounded retries, and credential-safe logging.

After completion, record final counts and credit use, document the handoff, close exceptions, and update the checklist with what changed. A repeatable workflow should become more predictable after every reconciled task.

  • Purpose and owner approved
  • Cost and limits reviewed
  • Failure handling tested
  • Secure result destination ready
  • Reconciliation responsibility assigned
  • Retention review scheduled
QUESTIONS

What teams ask before they start.

How does API authentication work?

Requests use MailMaker API keys. Separate keys can be created for production, staging, and development workflows.

How do I know when an order is complete?+

Retrieve the task by ID at a bounded interval and stop polling when its state becomes completed, partial, or failed.

Can requests be retried safely?+

The API design includes idempotent request handling so a client retry does not need to create a duplicate order.

What is guaranteed when an account fails?+

A failed item consumes zero credits. If credits were reserved while the item processed, they return to the workspace balance automatically. The guarantee protects the MailMaker creation charge, not permanent third-party account status.

READY WHEN YOU ARE

Credits in. Accounts out.

Start with the provider already selected. If an item fails, its credits return automatically.

Create your first task