Nylas v3 usage calculation and billing
💡 This page discusses billing for Nylas v3. If you need information about billing for your v2 Nylas implementation, see Nylas v2 usage calculation and billing.
Nylas bills you on the 5th of the month for the previous month's use (for example, the bill you get on October 5th is for the highest number of grants connected to your Nylas implementation between September 1st and 30th). Your bill might include your base plan, which can cover a specific number of connected accounts, and any overages you might have accrued.
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
🔍 In Nylas v3, "grants" replace "Connected Accounts". For billing purposes, they're referred to as "connected accounts" ("CAs"). To learn more about terminology changes in v3, see the v3 features and changes documentation.
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.
When you delete a grant, you're still charged for its use during the month. However, Nylas won't charge you for it on your next bill. For example, if you authenticate a grant on September 2nd, then delete it on September 15th, you're charged for it on your October 5th bill only.
Calculating usage for v3
If your organization is using both v2 and v3 APIs, Nylas calculates your usage based on a de-duplicated list of connected accounts.
If your organization migrated from Nylas v2 to v3, the number of connected accounts for both versions is combined on your invoice. Your organization is billed for v3 when it has at least one live v3 Nylas application with at least one active grant associated to it.
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.
Nylas v3 doesn't have explicit sync states, so an account's billing status changes only when a grant is created or deleted. Grants continue to be billable as long as they exist, including if they're in the invalid state.
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 v3 Nylas Dashboard, click the account menu at the top-right of the page, and select Billing. The Billing page shows your organization's plan settings, invoice information, and payment method.