v2.4.0

Changelog

Added

• Added webhook validation support (#238)

Changed

• Fixed issue where from field was not accessible when sending messages (#237)

v2.3.2

Changelog

Changed

• Fixed default When type (#235)
• Fixed issue where from field was not accessible when creating drafts (#233, #234)

New Contributors

• @burtonrhodes made their first contribution in #233

v2.3.1

Changelog

Changed

• Fixed code exchange response for scope value (#231)

v2.3.0

Added

• Added missing webhook triggers (#220)
• Added provider field to token exchange response (#225)
• Added support for clean messages endpoint (#226, #228)
• Added support for custom headers field for Drafts and Messages (#223)
• Added support for overriding various fields of outgoing requests (#224)

Changed

• Fixed issue where attachments < 3mb were not being encoded correctly (#227, #222)

v2.2.1

Changelog

Changed

• Improved message sending and draft create/update performance (#217)
• Change default timeout to match API (90 seconds) (#218)

v2.2.0

Changelog

Added

• Added support for roundTo field in availability response (#215)
• Added support for attributes field in folder model (#215)
• Added support for icloud as an auth provider (#215)

Changed

• Fixed builder for FindAttachmentQueryParams (#208)
• Fixed scopes to be optional for IMAP grants (#210)
• Fixed typo in updating grant schema (#211)
• Fixed endpoint for rotating webhook secrets (#212)
• Fixed response type for returning webhook IP addresses (#213)

Removed

• Removed unnecessary clientId from detectProvider params (#215)

v2.1.0

The first release adds support for a new endpoint and updates to some models.

Changelog

Added

• Add support for getting OAuth token info (#205)

Changed

• Fix schema issues in the Event, Message, Draft, and CodeExchangeResponse models (#203, #204, #205)

v2.0.0

The Nylas SDK for Kotlin & Java v2.0.0 is out of beta now Generally Available! This SDK sees a number of changes, including breaking changes, and more importantly brings full support of the new Nylas API v3 as well as full Kotlin support.

Changelog

Breaking changes

• Renamed artifact from nylas-java-sdk to nylas.
• Nylas SDK v2 supports the Nylas API v3 exclusively, dropping support for any endpoints that are not available in v3. See API v3 Features and Changes for more information.
• Removed all REST calls from models and moved them directly into resources.

Added

• Full Kotlin support.
• Created models for all API resources and endpoints, for all HTTP methods to reduce confusion on which fields are available for each endpoint.
• Created error classes for the different API errors as well as SDK-specific errors.

Updated

• Now using Moshi annotations for JSON serialization/deserialization as opposed to manually writing JSON maps.
• Removed all REST calls from models and moved them directly into resources.

Removed

• Non-builder ways for initializing NylasClient.
• Local Webhook development support is removed due to incompatibility with the new API version.

Docs and References

Please refer to the README.md for a quick description and getting started guide with the new SDK. Furthermore, we have an UPGRADE.md for instructions on upgrading from v1.x to v2.x, as well as a reference guide for the Kotlin & Java SDK.

v1.22.0

This release of the Nylas Java SDK comes with new features.

Release Notes

Added

• Added support for querying events using customer event ID (#153)
• Added support for overriding the Event ID when updating, for recurring events (#186)
• Added support for reply_to_message_id field in Message (#194)

v1.21.0

This release of the Nylas Java SDK comes with new features and a fix.

Release Notes

Added

• Added missing content_disposition field in File (#149)
• Added toJSON() and toMap() support to account owned models (#150)
• Added scheduler support for the EU region (#151)

Fixed

• Fixed NullPointerException sporadically occurring when calling Message.toString() (#149)

Usage

toJSON() and toMap()

public class NylasExample {
  public static void main(String[] args) throws Exception {
    NylasClient client = new NylasClient();
    NylasApplication application = client.application("CLIENT_ID", "CLIENT_SECRET");
    Event event = application.events().get("EVENT_ID");

    // Convert Event to JSON
    String eventJSON = event.toJSON();

    // Convert Event to Map
    Map<String, Event> eventMap = event.toMap();
  }
}

EU Scheduler

public class NylasExample {
  public static void main(String[] args) throws Exception {
    // Setup Nylas client, defaulting to US region
    NylasClient client = new NylasClient();
    NylasApplication application = client.account("ACESS_TOKEN");
    Schedulers usScheduler = application.schedulers(); // Scheduler URL pointing to https://api.schedule.nylas.com/

    // Setup Nylas client for the EU region
    NylasClient euClient = new NylasClient.Builder()
        .baseUrl(NylasClient.EU_BASE_URL)
        .build();
    NylasApplication euApplication = euClient.account("ACESS_TOKEN");
    Schedulers euScheduler = euApplication.schedulers(); // Scheduler URL pointing to https://ireland.api.schedule.nylas.com/
  }
}