Calculate Package

📐 Use this endpoint to calculate the domains, mailboxes, and pricing needed to hit a specific sending volume — before placing a custom order.
No subscription is created and no charge is made.
If you want to browse fixed pre-built packages instead, use the Get Packages endpoint.
→ Get Packages
Once you have your breakdown, use it to place your order with:
→ Create Custom Order

🔑 Request Body Parameters

All parameters below must be included in the JSON body.

`volume` (required)

The number of emails you want to send.

Must be greater than 0.

Interpreted as emails per day or per month depending on the period field.

`period` (optional)

The time period your volume refers to.

"month" (default) — volume is emails per month

"day" — volume is emails per day

`providers` (required)

An array of the email providers you want to use.

Must contain at least one value.

Supported values: "google", "outlook", "smtp"

"providers": ["google", "outlook"]

`distribution` (conditionally required)

Specifies what percentage of your volume each provider should handle.

Single provider — omit this field entirely, or pass { "<provider>": 100 }. The system will default to 100% automatically.

Multiple providers — required. All listed providers must be included and percentages must sum to exactly 100.

"distribution": {
  "google": 60,
  "outlook": 40
}

`tier` (optional)

Controls the sending volume tier, which affects how many mailboxes per domain are assumed.

"low" — conservative sending limits

"medium" — moderate sending limits

"max" (default) — maximum sending capacity per domain

Field	Description
`monthlyVolume`	Total emails per month
`dailyVolume`	Total emails per day
`providerBreakdown`	Per-provider domain, mailbox, and pricing details
`providerBreakdown[].requiredDomains`	Number of domains needed for that provider
`providerBreakdown[].requiredMailboxes`	Number of mailboxes needed for that provider
`providerBreakdown[].pricePerUnit`	Price per unit in cents
`providerBreakdown[].pricingBasis`	What the unit price is based on (e.g. `"domain"`)
`providerBreakdown[].totalPrice`	Total price for that provider in cents
`providerBreakdown[].percentage`	Distribution percentage assigned to that provider
`totalDomains`	Total domains across all providers
`totalMailboxes`	Total mailboxes across all providers
`totalPrice`	Total price across all providers in cents

⚠️ Error Responses

Volume too low — minimum 1 domain per ESP required

{
  "error": "Volume too low - Minimum 1 domain per ESP required",
  "message": "Your requested volume is below the minimum threshold",
  "requested": {
    "volume": 10,
    "period": "month"
  },
  "minimum_required": {
    "volume": 500,
    "period": "month"
  }
}

Invalid input

{ "error": "volume is required and must be greater than 0" }
{ "error": "providers array is required and must contain at least one provider (google, outlook, smtp)" }
{ "error": "period must be either 'day' or 'month'" }
{ "error": "tier must be one of: 'low', 'medium', 'max'" }
{ "error": "Distribution percentages must add up to 100. Current total: 90" }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

🔑 Request Body Parameters#

volume (required)#

period (optional)#

providers (required)#

distribution (conditionally required)#

tier (optional)#

⚠️ Error Responses#

Volume too low — minimum 1 domain per ESP required#

Invalid input#

Request

Responses