Nylas Docs

The Nylas Developer Hub

Welcome to the Nylas developer hub. You'll find comprehensive guides and documentation to help you start working with Nylas as quickly as possible, as well as support if you get stuck. Let's jump right in!

Developer Guide

Creating a Google Project and Client ID for Development

In order to connect Google accounts to Nylas through Hosted Authentication, you'll need to create your own Google Project and OAuth Client ID. This Google Project and Client ID will be used only for initial development and testing using Nylas, and you will configure Nylas to use the Client ID you create. If you have any trouble creating a Google Project and OAuth Client ID for development, get in touch with support@nylas.com and we'd be happy to help you out!

Ready for production?

Google requires a verification and security review process for applications that sync Google accounts in production. If you're ready to sync Google accounts in your production application, please reach out to Nylas support and we will help you through this process.

Create a Google Project

To get started, head over to https://console.developers.google.com/. You will be prompted to log in with a Google account if you're not already logged in with one.

If you don't have a Google account, you can create one at https://accounts.google.com/signup/:

Once your account has been created, head back over to https://console.developers.google.com and sign in with it.

Click on "Select a project" in the top left corner, and on the following screen click "NEW PROJECT":

Name your project and click "CREATE" in the bottom left corner:

It may take up to a minute or two to for Google to finish creating the project, after which you'll see a screen like this:

You've now created your Google Project! The next step is to enable the APIs needed to connect to Google via Nylas.

Enable APIs

Click the "ENABLE APIS AND SERVICES" button in the center of the screen

You'll be presented with the following search box:

Type "gmail" into the search box and click on the "Gmail API" card once it appears:

Click the large blue "ENABLE" button next to the Gmail logo

You'll find yourself on the following page. Click the search box in the center of the top bar:

Type "calendar" and click on "Google Calendar API" once it appears:

Click "ENABLE" for the Google Calendar API:

Please note: Contact scopes require both the People API and the Contacts API to be enabled.

Do the same for the Contacts API ("contacts" is a good search term):

As well as the People API (search "people"):

You've now enabled all of the APIs that Nylas needs to sync data.

Add Nylas as a Project Owner

To do this, click the hamburger icon in the top left-hand corner of the screen and then click on the "IAM" submenu under "IAM & admin":

Once through to the IAM page, click the "ADD" button near the middle top.

Enter "support@nylas.com", select "Owner" as the Role, and click the blue "SAVE" button:

Configure OAuth Consent Screen

The last step to do in the Google Developer Console is to create a credential for OAuth, starting with configuring the consent screen. Click the "CREATE CREDENTIALS" button that you should see as below after enabling the People API:

On the next screen, you'll want to click the "client ID" word:

Then click "configure consent screen":

On the following page, fill out the "Application name" field.

Scroll down, click "Add scope", select ../auth/calendar, ../auth/contacts, and ../auth/gmail.modify as the scopes for your consent screen, then click "ADD":

Finally, add api.nylas.com to the "Authorized domains" field and press enter. Your consent screen should look like this when you're done:

Scroll down to the bottom of the page and click the blue "Save" button!

Create an OAuth Credential

You should now find yourself on the following page.

Click "Create credentials" and select "OAuth client ID" from the drop-down menu.

You should see the following screen. Select "Web application" as your "Application type", name your credential, and fill in the value https://api.nylas.com/oauth/callback for "Authorized redirect URLs" and press enter:

Then click the blue "Create" button at the bottom of the screen.

You'll be presented with a page that shows your new OAuth Client ID and Secret. Keep this page open, as you'll need the credentials in the next step.

Configure Nylas to use your new Google OAuth Client ID and Secret

Head on over to https://dashboard.nylas.com/ and log in.

From the front page of the dashboard, click "View all applications" on the right-hand side of the "Application and API Key" section:

On the following page, click "Edit" on your application. You'll be presented with the Application Settings page and you'll want to click on the "Google OAuth" tab:

Copy-paste your Google OAuth Client ID and Secret from the Google Developer Console and click "Update Google OAuth Settings":

You are now all set to start connecting Google accounts to Nylas! Happy developing!

Once you're ready to move your application to production, get in touch with support@nylas.com to kick off the verification process and security review which is required by Google.

Creating a Google Project and Client ID for Development

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.