Nylas v2 usage calculation and billing

💡 This page discusses billing for Nylas v2. If you need information about billing for your v3 Nylas implementation, see Nylas v3 usage calculation and billing.

Nylas bills you on the 5th of the month for the previous calendar month's use (for example, the bill you get on October 5th is for the accounts connected between September 1st and September 30th). Your bill might include your base plan, which can include a specific number of connected accounts, and any overages.

The Nylas billing month is calculated in the UTC time zone. Take this into account if you plan to do periodic cleanup of connected accounts. This also means you might receive your bill a little early if you are in a time zone west of UTC.

How Nylas calculates usage

Nylas calculates your usage by multiplying the number of connected accounts by the effective price per account for your organization's billing plan. If the number of connected accounts per month is less than or equal to the number of accounts included in your billing plan, Nylas bills you the regular monthly ("base") rate for the plan. If your organization exceeds the number of connected accounts included in your billing plan, Nylas bills you the regular monthly rate plus a prorated amount for each extra account.

How Nylas identifies accounts

Each connected account is uniquely defined by both its associated email address and the server settings it uses to authenticate. This means that accounts are counted more than once if the same email address authenticates with different server settings. For example, if leyah@example.com authenticates on December 2nd with the mx.mail.com server setting, then re-authenticates on December 12th with the mailbox.mail.com server setting, the user is counted twice for December.

Accounts that are connected to multiple Nylas applications within your organization count as separate accounts.

Account re-authentication

If re-authenticating an account generates a new account_id, you can cancel the previous account and use only the new one to make sure Nylas doesn't bill you twice. You can also ask your users to re-authenticate using the same server settings to avoid this issue. For more information, see the account re-authentication documentation.

Account billing states

Nylas charges you for the accounts connected to your organization's v2 Nylas applications, so it's helpful to understand Nylas' account billing states.

💡 Tip: You can check an account's billing_state by making a Get all Accounts or Get Account request.

A connected account is one whose billing_state is paid for any period of time within a given month. Nylas doesn't prorate account usage within a month. If an account was connected at any time in a given month, Nylas counts it as connected for the entire month, regardless of the account's sync_state. For example, during September, if you have 50 accounts in a paid state and then authenticate a new account, you're charged for 51 accounts for September on October 5th.

The following table describes when Nylas charges for an account.

Billing State	Sync State	Does Nylas charge?
`paid`	`invalid`	☑️
`paid`	`running`	☑️
`paid`	`stopped`	☑️
`paid`	`partial`	☑️
`paid`	`exception`	☑️
`cancelled`	`invalid`	⬜
`cancelled`	`running`	⬜
`cancelled`	`stopped`	⬜
`cancelled`	`partial`	⬜
`cancelled`	`exception`	⬜
`deleted`	`invalid`	⬜
`deleted`	`running`	⬜
`deleted`	`stopped`	⬜
`deleted`	`partial`	⬜
`deleted`	`exception`	⬜

An account's billing_state is set to paid the first time you authenticate it to the Nylas API. If you downgrade or cancel it (the billing_state changes to cancelled) or delete the account (the billing_state changes to deleted), Nylas blocks any API requests made by that account.

You can upgrade a cancelled account to reactivate it. This changes its billing_state to paid and allows the account to make requests to the Nylas APIs.

Nylas data centers

Nylas offers multiple data centers to help you comply with legal requirements.

⚠️ If you authenticate the same account in multiple data centers, Nylas charges you for each occurrence of the connected account.

View paid invoices

Nylas stores your paid invoices. If you're an Administrator for your organization, you can view and download them in the Nylas Dashboard. Log in to the Nylas v2 Dashboard, click Org settings in the left navigation, and select the Billing tab. You can choose the invoice that you want to view or download from the Billing page.