Keep Track of your Nylas Invoice History with Ease

When it comes to integrating with the Nylas API (or any other API for that matter), we know managing your resources is an important consideration. Let’s take a look at how you can easily stay on top of your paid invoices and get this year off on the right foot. 

How Billing Works at Nylas

First, let’s get a quick overview of how billing works at Nylas. Nylas bills on the first of the month for the previous month’s usage – and usage is determined by multiplying the number of active accounts by the effective price per account for your organization’s billing plan. 

Want a PDF of this article?

Share it with a friend or save it for later reading.

Send me a PDF

How exactly is an active account defined? An active account is defined as one that has its billing_state set to paid for any period of time within a given month. In order to check an account’s billing state, you can make a GET call to the /accounts/{account_id} endpoint:

curl -X GET 'https://api.nylas.com/a/{client_id}/accounts/{account_id}}' \

-H 'Content-Type: application/json' \

-H 'Authorization: {client_secret}' \

The account object you receive in response will have the ‘billing_state’ as an attribute and look something like this:

{
    "account_id": "9c5cf3x4hgvwaoox2txxxxxxx",
    "billing_state": "paid",
    "email": "[email protected]",
    "id": "9c5cf3x4hgvwaoox2txxxxxxx",
    "provider": "eas",
    "sync_state": "running",
    "trial": false
}

The first time an account is added it will automatically have a billing_state that is paid. 

For more information about how billing works, check out our docs here!

Your Billing Dashboard 

Now, you can view your paid invoice by at any point by logging into your Nylas dashboard.  In the top right corner, click on the drop-down menu next to your name, and you will see ‘Billing’ underneath ‘Organization’. Clicking on ‘Billing’ will take you to a screen that looks like this:

In one place, you can conveniently see how many accounts are active, add or remove a card, and download a PDF of paid invoices. Now that you’ve got that sorted, go ahead and explore what the Nylas API can do!

Start Building your Nylas Integration Today

Get Started – Build your first integration with Nylas in 15 minutes.

Quickstart Guides – Get up to speed quickly with our SDKs for Python, Node.js, and Ruby or explore the Nylas Email, Calendar, and Contacts APIs.

How Nylas Works – Take a look at the Nylas architecture to see how we sync billions of emails.

Tutorials – Check out our tutorials to learn how to carry out common functionality like creating, reading and RSVP-ing to calendar events.

Integration Guides – Ready to start building your integration? Our integration guides cover what it takes to incorporate email functionality into your app. They cover best practices for using the Nylas Communications Platform and provider-specific advice for Google, Microsoft, IMAP, and more.

Set up Postman – Postman makes it easy to explore the Nylas Email API.