Welcome, friends, to our monthly episode of New in Nylas! 👋 The weather’s cooling down here in the northern hemisphere, but that’s not making us slow down. We’ve got some exciting updates again this month, but first…
Did you know we have RSS feeds?
Section titled “Did you know we have RSS feeds?”Point your RSS reader at us to subscribe to our SDK changelogs, our product Release notes, or both.
✨ As a friendly reminder, Nylas maintains compatibility within major versions. This means if you’re on Nylas v3, you don’t need to do anything to use the features we’re talking about here. (If you’re still using v2, we can’t wait to show you our latest and greatest! Check out the Upgrade guide.)
Nylas v2 deprecation news
Section titled “Nylas v2 deprecation news”Nylas v3 is our faster, more reliable, easier to use new platform, and we can’t wait to show you what you’re missing. To help us focus, Nylas is only making critical updates to Nylas v2 at this time.
To make sure you have time to finish your migration, we’ve extended the v2 deprecation date to December 31, 2024.
If you haven’t already, check out the Nylas v2 to v3 Upgrade guide for instructions on how to get started building your project on v3, and the App Migration guide, the Migration API references, and our detailed instructions on migrating the many types of Microsoft accounts out there.
Personalize your migration process with Migration Station
Section titled “Personalize your migration process with Migration Station”We also built Migration Station, a customized upgrade and data migration guide built for you based on what Nylas features you use. Fill out the form and build a guide, and save the URL to share or to come back to later. We’d love your feedback on it!
Updated Calendar scope requirement for Google grants
Section titled “Updated Calendar scope requirement for Google grants”For those of you that work with Google grants and the Nylas Calendar API, a bug we fixed this month means you might need to review and update the scopes you’re requesting. If you’re using the Events endpoints and using the primary keyword (instead of the calendar ID), Nylas now requires the https://www.googleapis.com/auth/calendar scope. If you’re referencing calendar IDs directly, you don’t need to change anything.
If you already request this scope (or a more permissive one), you don’t need to do anything. If you do need to update the scopes you’re requesting, have your users re-authenticate so they accept the new scope.
Decoded MIME fields for IMAP grants
Section titled “Decoded MIME fields for IMAP grants”Nylas now decodes MIME-encoded message fields for IMAP grants before returning them. This means that you don’t need to create logic to decode these fields in your project. If you already built a solution to decode these fields, be sure to update that section of your code to work with the new data format.
Bringing back the expand_recurring query parameter
Section titled “Bringing back the expand_recurring query parameter”In v3, Nylas expands recurring events by default when you make a Get all Events request. This means Nylas includes all the individual occurrences of the event along with the master event, and any edited occurrences of the event. In Nylas v2, we used the expand_recurring parameter to control this behavior to help you limit the Events results. You asked for it in v3, so we brought it back.
You can now set the expand_recurring query parameter to false in your request to return only the master event and any updated recurring events that fall in the time period for your query. For more information, see Exclude dates from a recurrence schedule.
Nylas API improvements and bug fixes
Section titled “Nylas API improvements and bug fixes”- We increased the character limit for the Message
tracking_options.labelfield to 2,048 characters, so you can give yourself longer notes about the purpose of tracking settings. - We fixed a bug where queries for a primary calendar would return the
primarykeyword instead of a calendar ID. Nylas now correctly returns the calendar ID. - We fixed an issue where using the
primarykeyword and calendar ID for the primary calendar interchangeably would return different data. - We fixed an issue with threaded messages where changing the subject line (for example, adding “FWD:”) would remove a message from its thread.
- We fixed a bug that caused the
attendeesquery parameter to be case-sensitive when listing Events for iCloud and Microsoft Graph grants.
Nylas SDK changelogs
Section titled “Nylas SDK changelogs”Our intrepid team of developers is always working to improve Nylas, and that includes the SDKs that we maintain. We had a few updates to the SDKs throughout September:
New and updated docs
Section titled “New and updated docs”We’re always working to make our docs better! This month, we’re pointing the spotlight at these pages:
- ✨ Configure authentication for the Scheduler Editor Component
- Create grants with OAuth and an access token
- Using virtual calendars
- Working with folders and labels
We’ve also got a big update to share…
Overhauled Getting Started and Quickstart guides
Section titled “Overhauled Getting Started and Quickstart guides”We’ve re-worked our Getting Started and Quickstart guides to make them shorter and easier to navigate. 🚀 This is a pretty major change, so — as always — feel free to reach out if you have any suggestions!
Latest Nylas Tech blogs
Section titled “Latest Nylas Tech blogs”Our DevRel team is hard at work bringing you cool demos built on Nylas v3. This month, they explored How to create an appointment scheduler in your React app.
That’s all for now
Section titled “That’s all for now”As always, we appreciate you joining us for our release. If you want to keep an eye on what’s coming to Nylas next, you can check our public roadmap.
Your feedback and suggestions about the Nylas platform are always welcome. If you have any comments or suggestions on the documentation, you can also drop us a line.
Until next time! 👋