Calendar API

Connect to 100% of users’ calendars for secure scheduling

Build custom scheduling in your app 10x faster than building from scratch.

  • Save time by avoiding the need to integrate and maintain connections with multiple providers (Google, Microsoft, etc.)
  • Allow users to manage their calendars, share links, and create shared resource calendars — all within your platform.
  • Get maintenance-free connections with a 99.9% guaranteed uptime.

Request a demo to see the Nylas Calendar API in action.

For more information about how this data is used, please view our Privacy Policy

Our simple
three-step
process.

01

Get a free API key

Create an account to unlock our full platform for up to 5 accounts — no credit card required

02

Build integrations quickly

With just a few lines of code, you get full create, read, update, delete (CRUD) capabilities and bi-directional sync.

03

Connect all your users

Whether you’re connecting 100 or 100 million accounts, you can rest easy knowing your data is safe.

For developers

Schedule meetings in minutes

With a few lines of code, build calendar CRUD capabilities and bi-directional sync.

Build for free

Node.js

Ruby

Python

Java

Curl

const events = await nylas.events.list({
  identifier: 1,
  queryParams: {
    calendarId: 2
  }
})
require 'nylas'

nylas = Nylas::Client.new(api_key: 'API_KEY')
query_params = { limit: 5 }
messages, _ = nylas.messages.list(identifier: '<GRANT_ID>', query_params: query_params)

messages.each {|message|
    puts "[#{Time.at(message[:date]).strftime("%d/%m/%Y at %H:%M:%S")}] \
           #{message[:subject]}"
} 
events = nylas.events.list(
  grant_id,
  query_params={
    "calendar_id": 1
  }
)
import com.nylas.NylasClient;
import com.nylas.models.*;
import java.text.SimpleDateFormat;

public class ReadInbox {
    public static void main(String[] args) throws NylasSdkTimeoutError, NylasApiError {
        NylasClient nylas = new NylasClient.Builder("<API_KEY>").build();
        ListMessagesQueryParams queryParams = new 
        ListMessagesQueryParams.Builder().limit(5).build();
        ListResponse<Message> message = nylas.messages().list("<GRANT_ID>", queryParams);

        for(Message email : message.getData()) {
            String date = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").
                format(new java.util.Date((email.getDate() * 1000L)));

            System.out.println("[" + date + "] | " + email.getSubject());
        }
    }
} 
curl --request POST \
--url https://api.us.nylas.com/v3/grants/<GRANT_ID>/events
--header 'Accept: application/json' \
--header 'Authorization: Bearer <API_KEY_OR_ACCESS_TOKEN>' \
--header 'Content-Type: application/json'

Node.js

Ruby

Python

Java

Curl

const draft = new Draft.default(nylas, {
  subject: "With Love, from Nylas",
  body: "This email was sent using the Nylas email API.",
  to: [{ name: "Nyla", email: "[email protected]" }],
});
const message = await draft.send();
require 'nylas'

nylas = Nylas::Client.new(api_key: "<API_KEY>")

# Call a list of calendars
calendars, _request_ids = nylas.calendars.list(identifier: "<GRANT_ID>", query_params: {limit: 5})

calendars.each {|calendar|
    puts calendar
}  
draft = nylas.drafts.create()
draft.subject = 'With Love, from Nylas'
draft.body = 'This email was sent using the Nylas email API.'
draft.to = [{'name': 'Nyla', 'email': '[email protected]')}]
message = draft.send()
import com.nylas.NylasClient;
import com.nylas.models.*;
import java.util.List;

public class read_calendars {
    public static void main(String[] args) throws NylasSdkTimeoutError, NylasApiError {
        NylasClient nylas = new NylasClient.Builder("<API_KEY>").build();
        ListCalendersQueryParams listCalendersQueryParams = new  
        ListCalendersQueryParams.Builder().limit(5).build();
        List<Calendar> calendars = nylas.calendars().list(dotenv.get("CALENDAR_ID"), 
        listCalendersQueryParams).getData();

        for (Calendar calendar : calendars) {
            System.out.println(calendar);
        }
    }
}
curl --request POST \
  --url https://api.nylas.com/send \
  --data '{
  "subject": "From Nylas",
  "to": [
    {
      "email": "[email protected]",
      "name": "Nyla"
    }
  ],
  "from": [
    {
      "name": "Developer Relations",
      "email": "[email protected]"
    }
  ],
  "body": "This email was sent using the Nylas email API.",
}'

Node.js

Ruby

Python

Java

Curl

const contact = new Contact(nylas);

contact.givenName = 'Nyla'
contact.birthday = '2014-06-01'
contact.companyName = 'Nylas'
contact.jobTitle = 'Communications Platform'
contact.officeLocation = 'San Francisco'
contact.notes = 'Check out the Nylas Email, Calendar, and Contacts APIs'
contact.emailAddresses = [new EmailAddress({
  type: 'work', email: '[email protected]'
})];
contact.save();
require 'nylas'	

nylas = Nylas::Client.new(
	api_key: “<API_KEY”
)

query_params = {
    limit: 5
}

contacts, _ = nylas.contacts.list(identifier: ENV["GRANT_ID"], query_params: query_params)
contacts.each {|contact|
    puts "Name: #{contact[:given_name]} #{contact[:surname]} | " \
    "Email: #{contact[:emails][0][:email]} | ID: #{contact[:id]}"
}
contact = nylas.contacts.create()
contact.given_name = 'Nyla'
contact.office_location = 'San Francisco'
contact.company_name = 'Nylas'
contact.notes = 'Check out the Nylas Email, Calendar, and Contacts APIs'
contact.manager_name = 'Communications'
contact.job_title = 'Communications Platform'
contact.birthday = datetime(2014, 6, 1)
contact.emails['work'] = ['[email protected]']
contact.save()
import com.nylas.NylasClient;
import com.nylas.models.*;

public class ReadAllContacts {
   public static void main(String[] args) throws
           NylasSdkTimeoutError, NylasApiError {
       NylasClient nylas = new NylasClient.Builder("<API_KEY>").build();

       ListContactsQueryParams queryParams =
               new ListContactsQueryParams.Builder().
                       limit(5).build();

       ListResponse<Contact> contacts = nylas.contacts().list(dotenv.get("GRANT_ID"),
       queryParams);

       for(Contact contact : contacts.getData()){
           assert contact.getEmails() != null;
           System.out.printf("Name: %s | Email: %s | Id: %s%n",
                   contact.getGivenName(),
                   contact.getEmails().get(0).getEmail(),
                   contact.getId()
                   );
       }
   }
}
curl --request POST \
  --url https://api.nylas.com/contacts \
  --data '{
  "birthday": "2014-06-01",
  "company_name": "Nylas",
  "emails": [
    {
      "email": "[email protected]",
      "type": "work"
    }
  ],
  "given_name": "Nyla",
  ],
  "job_title": "Nylas Mascot",
  "phone_numbers": [
    {
      "number": "1 800 GO NYLAS",
      "type": "business"
    }
  ],
  "web_pages": [
    {
      "type": "work",
      "url": "nylas.com"
    }
  ],
}'

Response

{
    "request_id": "cbd60372-df33-41d3-b203-169ad5e3AAAA",
    "data": [
        {
            "busy": true,
            "calendar_id": "primary",
            "conferencing": {
                "details": {
                    "meeting_code": "ist-****-tcz",
                    "url": "https://meet.google.com/ist-****-tcz"
                },
                "provider": "Google Meet"
            },
            "created_at": 1701974804,
            "creator": {
                "email": "[email protected]",
                "name": ""
            },
            "description": null,
            "grant_id": "1e3288f6-124e-405d-a13a-635a2ee54eb2",
            "hide_participants": false,
            "html_link": "https://www.google.com/calendar/event?eid=NmE0dXIwabQAAAA",
            "ical_uid": "[email protected]",
            "id": "6aaaaaaame8kpgcid6hvd",
            "object": "event",
            "organizer": {
                "email": "[email protected]",
                "name": ""
            },
            "participants": [
                {
                    "email": "[email protected]",
                    "status": "yes"
                },
                {
                    "email": "[email protected]",
                    "status": "yes"
                }
            ],
            "read_only": true,
            "reminders": {
                "overrides": null,
                "use_default": true
            },
            "status": "confirmed",
            "title": "Holiday check in",
            "updated_at": 1701974915,
            "when": {
                "end_time": 1701978300,
                "end_timezone": "America/Los_Angeles",
                "object": "timespan",
                "start_time": 1701977400,
                "start_timezone": "America/Los_Angeles"
            }
        }
    ]
}
{
    "type": "event.created2",
    "data": {
      "object": {
        "busy": true,
        "calendar_id": "mock-name%40nylas.com",
        "created_at": 1234567890,
        "description": "mock description",
        "hide_participants": false,
        "ical_uid": "[email protected]",
        "id": "mock-data-id",
        "object": "event",
        "owner": "Mock Owner <[email protected]>",
        "organizer": {
          "name": "mock organizer name",
          "email": "[email protected]"
        },
        "participants": [
          {
            "email": "[email protected]",
            "name": "mockParticipantsA",
            "status": "yes"
          },
          {
            "email": "[email protected]",
            "name": "mockParticipantsB",
            "status": "noreply"
          }
        ],
        "read_only": false,
        "reminders": null,
        "status": "confirmed",
        "title": "mock_title",
        "updated_at": 1234567890,
        "when": {
          "start_time": 1234567890,
          "start_timezone": "America/Edmonton",
          "end_time": 1234567890,
          "end_timezone": "America/Edmonton",
          "object": "timespan"
        }
      }
    }
  }  
{
    "type": "event.created3",
    "data": {
      "object": {
        "busy": true,
        "calendar_id": "mock-name%40nylas.com",
        "created_at": 1234567890,
        "description": "mock description",
        "hide_participants": false,
        "ical_uid": "[email protected]",
        "id": "mock-data-id",
        "object": "event",
        "owner": "Mock Owner <[email protected]>",
        "organizer": {
          "name": "mock organizer name",
          "email": "[email protected]"
        },
        "participants": [
          {
            "email": "[email protected]",
            "name": "mockParticipantsA",
            "status": "yes"
          },
          {
            "email": "[email protected]",
            "name": "mockParticipantsB",
            "status": "noreply"
          }
        ],
        "read_only": false,
        "reminders": null,
        "status": "confirmed",
        "title": "mock_title",
        "updated_at": 1234567890,
        "when": {
          "start_time": 1234567890,
          "start_timezone": "America/Edmonton",
          "end_time": 1234567890,
          "end_timezone": "America/Edmonton",
          "object": "timespan"
        }
      }
    }
  }  
 

Webhooks

Receive real-time notifications to monitor events and trigger automated workflows.

Sandbox environment

Experiment with our API with pre-configured settings in the Nylas Dashboard.

SDKs

Fast-track your integration with our Node.js, Ruby, Python, Java and Kotlin SDKs.

Trusted by over 250,000 developers worldwide

Logo Logo Logo Logo Logo