Billing
Nylas bills on the first of the month for the prior month’s usage. Nylas calculates your usage by multiplying the number of active accounts by the effective price per account for your organization’s current billing plan. If your number of active accounts per month is less than or equal to the number of accounts included in your billing plan, Nylas bills you the regular monthly rate for the plan. If you exceed the number of active accounts included in your plan, Nylas bills you the regular monthly rate, with an additional prorated amount for each extra account. Your organization's prorated price per account is equal to monthly_rate / included_accounts.
Billing states
You can check the billing_state
by making a GET /a/{client_id}/accounts or GET /a/{client_id}/accounts/{id} request.
An active account is an account whose billing_state
changes to paid
for any period of time within a given month. Nylas doesn't prorate account usage within a month. Regardless of account sync state (sync_state
), if an account was active for any period of time within a given month, Nylas counts it as an active account for the entire month.
The following table describes when Nylas charges an account:
billing_state | sync_state | Does Nylas charge? |
---|---|---|
paid | invalid | Yes |
paid | running | Yes |
paid | stopped | Yes |
paid | partial | Yes |
paid | exception | Yes |
cancelled | invalid | No |
cancelled | running | No |
cancelled | stopped | No |
cancelled | partial | No |
cancelled | exception | No |
deleted | invalid | No |
deleted | running | No |
deleted | stopped | No |
deleted | partial | No |
deleted | exception | No |
An account's billing_state
switches to paid
the first time you authenticate it to the Nylas API. If you downgrade/cancel (cancelled
) or delete (deleted
) an account, Nylas blocks any API requests made by the user. You can upgrade a cancelled account to reactivate it and change its billing_state
to paid
.
Account identification
An account is uniquely defined by both its 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 [email protected]
authenticates on 12/2 with server settings mx.mail.com
, and then re-authenticates on 12/12 with server settings mailbox.mail.com
, the user is counted twice for December.
Account re-authentication
If re-authentication generates a new account_id
, you can cancel the previous account and use the new one only to make sure Nylas doesn't bill you twice. You can also ask your users to re-authenticate with the same server settings to avoid this issue. For more information, refer to Account re-authentication. Accounts shared between multiple applications within your organization count as separate accounts.
Data centers
Nylas offers datacenter selection options to help you comply with legal requirements. There may be an additional charge for use of multiple data centers or for specific data centers.
If you authenticate the same account in multiple data centers, Nylas charges for each authentication at each data center.
Viewing invoices
To view and download paid invoices:
- Log in to the Nylas Dashboard.
- Click Org Settings.
- Click the Billing tab.