Integrate Apple Calendar API Easily with Nylas Calendar API
Apple Calendar API

Trusted & secure integration for Apple Calendar API

Apple has no public REST API for iCloud Calendar. Apps use EventKit on Apple devices, or CalDAV from a server. The Nylas Calendar API wraps CalDAV in a JSON REST API, alongside Google and Microsoft.

The Nylas Calendar API provides full-featured integrations that quickly and easily sync your app with Apple Calendar, and every other major calendar provider in the world.

  • Direct compatibility with the Apple 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 Apple Calendar standards.

Updated November 12, 2026

For developers

Schedule meetings in minutes with the Apple Calendar API integration

With a few lines of code, build calendar CRUD capabilities and bi-directional sync to solve integration challenges with Apple calendars.

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 Apple Calendar API integration with our Node.js, Python, Ruby and Kotlin/Java SDKs.

Nylas APIs power integrations with Apple Calendar & more

Create fully functional, bi-directional syncing between your application and Apple Calendars with the Nylas Calendar API, which connects to iCloud over CalDAV.

Bi-directional sync & full CRUD

Sync data bi-directionally between Apple Calendars and your app, and enable full CRUD (create, read, update, and delete) access natively within your application.

Seamless user experience

Allow users to access their iCal events directly from your application.

Embed scheduling instantly from any calendar
The Nylas API for Apple Calendar provides calendar access for all users

Ensure your application works with all of its potential users, without the cost and maintenance burden of building custom solutions for connecting with each individual calendar provider.

  • Apple Calendar users are on the rise – don’t alienate a key segment of your customer base
  • Bypass the complications of maintaining iCal integrations
  • Sync historical and live events in real-time
Calculate your savings with the Nylas APIs
Everything is secure. Everything is connected.

Nylas adheres to SOC 2 Type II, GDPR, HIPAA BAA, HITECH, ISO 27001, and CCPA. Data from every calendar you sync is encrypted and isolated with multi-level permission checks.

  • Enterprise-grade security 
  • Token management
  • Whitelisted IPs
  • Data encryption
  • Granular authentication scopes
  • Gated permission checks
Download the Security Whitepaper

What should I know about iCloud?

  • Users sign in with an Apple Account email and an app-specific password.
  • calendar_id=primary is not supported, so fetch the calendar ID first.
  • Listing events is capped to a one-year range.
  • Free/busy is not available for iCloud.

Read the full guide: Apple Calendar API: CalDAV, EventKit, and REST

Connect iCloud accounts: Authenticating iCloud accounts with Nylas

Learn more about the Nylas Calendar API and calendar integration.

Frequently asked questions

What are some challenges with the Apple Calendar API?

Apple has no public REST API for iCloud Calendar. EventKit works only inside apps on Apple devices, so a server-side integration means building and maintaining your own CalDAV client.

With a single connection to Nylas, developers can build applications that integrate Apple Calendar, allowing users to view and manage their events and reminders from within the app. Our API supports various features such as recurring events, alarms, time zones, and invitations.

How does the Nylas API integrate with Apple Calendar, and how can I start the integration?

You can build a connection to Apple Calendar in your application using the Nylas Calendar API. Nylas connects to iCloud over CalDAV and returns events as JSON through the Nylas Calendar API. Offering an Apple Calendar integration with Nylas gives your application productivity-boosting features such as but not limited to:

  • Bi-directional sync and full CRUD
  • Real-time notifications and with RSVP capabilities
  • Scheduler capabilities

Learn more about integrating with Apple Calendar in our docs here

 

What are some common issues with Apple Calendar API integrations, and how can Nylas help me avoid them?

When integrating Apple Calendar with other services or devices, users may encounter common issues such as syncing problems, duplicated events, and missing events. These can be caused by connectivity issues, outdated software, conflicting settings, and other factors. 

A calendar API like the Nylas Calendar API can help to address these common issues. It offers a robust sync engine that ensures events and appointments are synced in real time across all devices and services. It also de-duplicates events, uses advanced algorithms to identify and resolve missing events, and allows for customizations such as adding custom fields or event types.

What languages does the Nylas Calendar API support when connecting to Apple Calendar?

Nylas offers SDKs for Node.js, Python, Ruby and Kotlin/Java to make calendar integrations with our APIs easier for developers.

Does Apple have a public calendar API?

No. Apple has no public REST API, developer portal or API key for iCloud Calendar. EventKit works only inside apps on Apple devices, and CalDAV is the protocol for server access. Nylas wraps CalDAV behind a JSON REST API.

Does the Apple Calendar API support OAuth?

Not in the way Google and Microsoft do. Sign in with Apple can request only a user’s name and email address, so it never grants calendar access. Nylas signs users in with their Apple Account email and an app-specific password. Apple has a separate route for authorizing supported third-party apps through the Apple Account, but the Nylas iCloud connector uses the app-specific password. In PHP, call the Nylas REST API directly with any HTTP client, such as cURL, because there is no official Nylas PHP SDK for the current API.

How do I read iCloud events from JavaScript?

Send one HTTPS request to GET /v3/grants/{grant_id}/events with a real calendar_id. Nylas returns JSON, so you need no CalDAV client or XML parser.

What is an app-specific password?

A separate password a user generates in their Apple Account so a third-party app can reach iCloud Mail, Calendar and Contacts without seeing the main password. Apple requires two-factor authentication on the account.