Skip to content
Facteur

Type at least two characters.

Track your consumption and how long messages are kept

Receiving a message uses your quota, reading it uses nothing, and every message is deleted after the number of days of your plan.

Two different limits apply to your organization: how many messages you can receive in the period, and how long they are kept.

The figures of your plan are in the Pricing section of Settings → Billing. They are not copied here, so that a stale value cannot linger in an article.

What uses your quota, and what uses nothing

Your volume is counted in operations. An operation is a message received and kept, never a call to the API. Received SMS do not count toward this volume.

What you do What it uses
Receive an email in an inbox 1 operation
Read that message, once or forty times Nothing
Search for it every second until it arrives Nothing
List your inboxes, search, download an attachment Nothing
Receive a message while a limit is reached Nothing: it is refused, its content is not kept

The rule that places any case without consulting this table: you pay when a message arrives. Never when you read it.

A test that receives 3 emails and rereads them 40 times therefore uses 3 operations, not 43. You can poll the API as often as you like without watching the counter. The only ceiling on your calls is technical: 600 requests per minute per API key.

Volume is counted per organization

Not per inbox, not per workspace. The organization carries the plan, the seats and the included volume.

Workspaces therefore have no effect on the counter: spreading your traffic across several workspaces moves no ceiling of the plan.

When a limit is reached

The receiving server accepts the message, then Facteur refuses it: it is recorded with the status quota_exceeded, its content is not kept, and you are billed nothing for it. The sender therefore gets no SMTP error. The errorCode field of the message says which limit refused it:

errorCode The limit reached
PLAN_QUOTA_EXCEEDED The volume of the plan is used up and no overage is open (Free plan, or a spending cap of zero, its value until you set it)
OVERAGE_CAP_REACHED The spending cap beyond the included volume
DAILY_SPIKE_CAP The overage limit of a single day: reception resumes the next day
INBOX_QUOTA_EXCEEDED The limit you set on the inbox
WORKSPACE_QUOTA_EXCEEDED The limit you set on the workspace
SUBSCRIPTION_SUSPENDED A late payment, see Alerts

You see it in three places:

  1. In the API, on the message concerned: status: "quota_exceeded" and errorCode, without the extracted fields. See Read from your tests.
  2. In the application, in the message list, where it is marked Refused.
  3. In the application, on the billing Consumption screen, which counts the refusals by cause and by inbox.

To receive again: buy a pack, raise the spending cap, or wait for the next period. See Billing.

Set a limit per inbox or per workspace

Beyond the volume of the plan, you can set a limit on an inbox or on a workspace, from Quotas and alerts in the workspace menu. Example: with a limit of 200 messages per day on an inbox, a test suite that runs wild and sends 5,000 emails stops at 200, instead of draining the volume of the whole organization.

A limit is set per day or per month, as a number of messages, or for the month as a share of the plan's volume. At the ceiling, you choose to refuse the following messages, or to accept them and be warned. It reserves nothing: the sum of the limits of your inboxes can exceed the volume of the plan.

Not every plan includes these limits. The Pricing section of billing says which do, and the Quotas and alerts screen names the required plan when yours does not include them. You can always remove a limit that is already set.

Facteur also writes to you at 80% and 100% of your volume, and warns you when the pace of the last few days would use it up before the end of the period. See Be warned before reception stops.

How long a message is kept

Every message is deleted when it passes the duration of its inbox, a number of days set by your plan. That duration shows in the inbox list, in the Retention column, and on the inbox page. The API gives the deletion date of each message in expiresAt. If your plan changes, the duration of your inboxes follows.

Deletion removes the row and the raw file, as well as the attachments. It runs every hour, waits for no action from you, and cannot be turned off.

Your test messages contain reset links, one-time codes and sometimes real addresses. Keeping them indefinitely would be a risk for you. See Data and sovereignty.

Buy volume without changing plan

Your subscription sells the features, the seats and the retention duration. Volume is bought separately, in prepaid packs: raising your capacity never changes your subscription. A pack requires a paid plan. See Billing.

Known limits

  • No consumption history. The Consumption screen shows the current period, with no curve over previous periods.
  • The real payment provider is not connected yet, so buying a pack with a real card still goes through us. See Billing.