Microsoft 365 (Office 365) Calendar API Integration for Your App

Calendar API for Microsoft 365 (Office) calendar integration

The Nylas Calendar API abstracts away the complexity of syncing your application with your users’ Microsoft 365 calendars (formerly Office 365), and every other major calendar provider, making it simple and fast for your users to schedule events.

  • Direct compatibility with the Microsoft 365 (Office) Calendar, a unified API to facilitate seamless bi-directional calendar integration. 
  • Access to necessary calendar functionalities, such as event creation, updates, notifications, scheduled send, and reminders, across providers via a single API. 
  • Enhanced security and compliance features, ensuring data protection and privacy in line with Microsoft 365 (Office) Calendar standards.
For developers

Schedule meetings in minutes

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

See the docs

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());
        }
    }
} 
--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: "nyla@nylas.com" }],
});
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': 'nyla@nylas.com')}]
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": "nyla@nylas.com",
      "name": "Nyla"
    }
  ],
  "from": [
    {
      "name": "Developer Relations",
      "email": "devrel@nylas.com"
    }
  ],
  "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: 'nyla@nylas.com'
})];
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'] = ['nyla@nylas.com']
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": "nyla@nylas.com",
      "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": "anna.molly@example.com",
                "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": "6aaaaaaame8kpgcid6hvd0q@google.com",
            "id": "6aaaaaaame8kpgcid6hvd",
            "object": "event",
            "organizer": {
                "email": "anna.molly@example.com",
                "name": ""
            },
            "participants": [
                {
                    "email": "jenna.doe@example.com",
                    "status": "yes"
                },
                {
                    "email": "anna.molly@example.com",
                    "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": "mock_uids@google.com",
        "id": "mock-data-id",
        "object": "event",
        "owner": "Mock Owner <mock_owner@example.com>",
        "organizer": {
          "name": "mock organizer name",
          "email": "mock_email@example.com"
        },
        "participants": [
          {
            "email": "mockParticipantsA@example.com",
            "name": "mockParticipantsA",
            "status": "yes"
          },
          {
            "email": "mockParticipantsB@example.comm",
            "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": "mock_uids@google.com",
        "id": "mock-data-id",
        "object": "event",
        "owner": "Mock Owner <mock_owner@example.com>",
        "organizer": {
          "name": "mock organizer name",
          "email": "mock_email@example.com"
        },
        "participants": [
          {
            "email": "mockParticipantsA@example.com",
            "name": "mockParticipantsA",
            "status": "yes"
          },
          {
            "email": "mockParticipantsB@example.comm",
            "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

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.

Integrate with Microsoft 365 (Office 365) calendars in a fraction of the time

When integrating users’ Google Calendars into your app, there are a host of challenges the Nylas Calendar API solves for you, including:

Application integration

Free-busy endpoint

Streamline scheduling by querying free/busy information for a calendar during a certain time without compromising sensitive information about events, like the location.

Events

Recurring events

Support for creating, updating, and deleting recurring events so your users can easily schedule recurring meetings.

Customizable scheduling

Fully own your application scheduling experience by giving your developers the flexibility to quickly build customizable workflows for your users.

Embed scheduling instantly from any calendar
Save costs integrating with Microsoft 365 calendar integration

As your platform scales and your user base grows, so do costs for maintaining the Microsoft 365 calendar integration on your own. Nylas handles these for you, including costs for:

 

  • Scalability — as your platform scales and your user base grows, Nylas has the infrastructure to handle increased usage and ensure reliable performance.
  • Resolving breaking changes — Microsoft had 13 calendar updates for its Graph API in 2020 alone
  • Granular scopes — Nylas offers a comprehensive set of granular scopes, allowing you to fine-tune the permissions and access levels for your calendar integration.
  • Troubleshooting Microsoft 365-s — Let Nylas troubleshoot Microsoft 365-specific bugs and challenges that may occur during the integration, ensuring smooth functionality without any hassle on your part.

 

With Nylas APIs, you can offload the burden of ongoing maintenance tasks. Our APIs come with out-of-the-box security, and we power even more granular scopes than most providers to improve security for your end-users.

Calculate your savings with the Nylas APIs
At Nylas, securing your data is paramount

With robust security measures ingrained into the core of Nylas’ products, you can have peace of mind, knowing that your data is always safeguarded and secure. Data from every calendar you sync is encrypted and isolated with multi-level permission checks. Nylas adheres to SOC 2 Type II, GDPR, HIPAA BAA, HITECH, ISO 27001, and CCPA.

  • Encryption and access control
  • Network transport and storage
  • Infrastructure and physical security
  • Operational security
  • Around-the-clock monitoring
Download the Security Whitepaper

Start building the future

Get your API key and connect up to 5 accounts for free.

Image
Frequently Asked Questions

What is Microsoft 365 Calendar API integration?

Microsoft 365 Calendar API integration is the process of incorporating the Microsoft 365 Calendar functionality into an application or system using the API. The API allows developers to access and manipulate calendar-related data, such as creating, updating, and retrieving events, managing calendars, and handling notifications.

By integrating the Microsoft 365 Calendar API, developers can enable users to interact with their Microsoft 365 calendars within their applications. This integration empowers users to view, schedule, and manage events and appointments from their Microsoft 365 calendars without switching between different platforms or interfaces.

How do I get started integrating with the Microsoft 365 Calendar API?

To start integrating with the Microsoft 365 Calendar API, first, create a Microsoft 365 developer account. Register your application in the Azure portal to obtain credentials. Implement authentication to get an access token, and use it to make API requests for managing calendar events and performing other operations.

How do I integrate Microsoft 365 Calendar API with my app?

EWS provides a SOAP implementation and C# client library for full access to Exchange calendars, or you can use Nylas to abstract away the complexity and receive a simplified integration process. 

Both APIs organize calendars and events, but Nylas provides a JSON format for easier implementation. With EWS, you need to authenticate the account and handle permissions, whereas Nylas offers hosted authentication for Microsoft accounts. 

For more details on integrating the Microsoft 365 Calendar API with your app, check out our step-by-step blog post.

How do I authenticate and authorize access for Microsoft 365 Calendar API Integration?

To authenticate and authorize access for Microsoft 365 Calendar API integration, you must register your app and obtain credentials from the Azure portal. Use the obtained access token to request API requests to the Microsoft 365 Calendar API, ensuring your app can access the user’s calendar information. Choose an authentication flow for your app, allowing users to log in and grant permission to access their calendar data.