{"id":28473250,"url":"https://github.com/nylas/nylas-java","last_synced_at":"2025-07-02T02:30:54.214Z","repository":{"id":37900510,"uuid":"202446537","full_name":"nylas/nylas-java","owner":"nylas","description":"Nylas Java SDK","archived":false,"fork":false,"pushed_at":"2025-07-01T13:13:12.000Z","size":930,"stargazers_count":32,"open_issues_count":6,"forks_count":19,"subscribers_count":39,"default_branch":"main","last_synced_at":"2025-07-01T14:28:16.100Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nylas.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"Contributing.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-08-15T00:37:34.000Z","updated_at":"2025-06-25T16:00:39.000Z","dependencies_parsed_at":"2023-02-18T11:01:54.160Z","dependency_job_id":"9c3d61a1-6131-4576-9c18-cb8ff66b1f7d","html_url":"https://github.com/nylas/nylas-java","commit_stats":null,"previous_names":[],"tags_count":58,"template":false,"template_full_name":null,"purl":"pkg:github/nylas/nylas-java","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nylas%2Fnylas-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nylas%2Fnylas-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nylas%2Fnylas-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nylas%2Fnylas-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nylas","download_url":"https://codeload.github.com/nylas/nylas-java/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nylas%2Fnylas-java/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263063861,"owners_count":23407999,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-07T12:06:39.282Z","updated_at":"2025-07-02T02:30:54.188Z","avatar_url":"https://github.com/nylas.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca href=\"https://www.nylas.com/\"\u003e\n    \u003cimg src=\"https://brand.nylas.com/assets/downloads/logo_horizontal_png/Nylas-Logo-Horizontal-Blue_.png\" alt=\"Aimeos logo\" title=\"Aimeos\" align=\"right\" height=\"60\" /\u003e\n\u003c/a\u003e\n\n# Nylas SDK for Kotlin \u0026 Java\n\n![Maven Central Version](https://img.shields.io/maven-central/v/com.nylas.sdk/nylas)\n[![codecov](https://codecov.io/gh/nylas/nylas-java/graph/badge.svg?token=R94RD91GZ3)](https://codecov.io/gh/nylas/nylas-java)\n\nThis is the GitHub repository for the Nylas SDK for Kotlin and Java. This repo is primarily for anyone who wants to make contributions to the SDK or install it from source. For documentation on how to use this SDK to access the Nylas Email, Calendar, or Contacts APIs, see the official [Java SDK Quickstart Guide](https://developer.nylas.com/docs/sdks/java/).\n\nThe Nylas Communications Platform provides REST APIs for [Email](https://developer.nylas.com/docs/email/), [Calendar](https://developer.nylas.com/docs/calendar/), and [Contacts](https://developer.nylas.com/docs/contacts/), and the Nylas SDK is the quickest way to build your integration using Kotlin or Java.\n\nHere are some resources to help you get started:\n\n- [Sign up for your free Nylas account](https://dashboard.nylas.com/register)\n- [Nylas API v3 Quickstart Guide](https://developer.nylas.com/docs/v3-beta/v3-quickstart/)\n- [Nylas SDK Reference](https://nylas-java-sdk-reference.pages.dev/)\n- [Nylas API Reference](https://developer.nylas.com/docs/api/)\n- [Nylas Samples repo for code samples and example applications](https://github.com/orgs/nylas-samples/repositories?q=\u0026type=all\u0026language=java)\n\nIf you have a question about the Nylas Communications Platform, [contact Nylas Support](https://support.nylas.com/) for help.\n\n## ⚙️ Install\n\n**Note:** The Nylas SDK for Kotlin \u0026 Java requires JRE 8 or later.\n\n### Set up using Gradle\n\nIf you're using Gradle, add the following to the dependencies section of `build.gradle`:\n\n```groovy\nimplementation(\"com.nylas.sdk:nylas:2.11.0\")\n```\n\n### Build from source\n\nTo build from source, clone this repo and build the project with Gradle.\n\n```shell\ngit clone https://github.com/nylas/nylas-java.git \u0026\u0026 cd nylas-java\n./gradlew build uberJar\n```\n\nThis creates a new jar file in `build/libs/nylas-java-sdk-2.11.0-uber.jar`.\n\nSee the Gradle documentation on [Building Libraries](https://guides.gradle.org/building-java-libraries/)\nor the [Gradle User Manual](https://docs.gradle.org/current/userguide/userguide.html) for more information.\n\n## ⚡️Usage\n\nTo use this SDK, you must first [get a free Nylas account](https://dashboard.nylas.com/register).\n\nThen, follow the Quickstart guide to [set up your first app and get your API keys](https://developer.nylas.com/docs/v3-beta/v3-quickstart/).\n\nFor code examples that demonstrate how to use this SDK, take a look at our [Java repos in the Nylas Samples collection](https://github.com/orgs/nylas-samples/repositories?q=\u0026type=all\u0026language=java).\n\n### 🚀 Making Your First Request\n\nYou use the `NylasClient` object to make requests to the Nylas API. The SDK is organized into different resources, each of which has methods to make requests to the API. Each resource is available through the `NylasClient` object configured with your API key.\n\nFor example, to get a list of calendars, you can use the following code:\n\n```java\nNylasClient nylas = new NylasClient.Builder(\"API_KEY\").build();\nListResponse\u003cCalendars\u003e calendars = nylas.calendars().list(\"GRANT_ID\");\n```\n\n## 📚 Documentation\n\nNylas maintains a [reference guide for the Kotlin and Java SDK](https://nylas-java-sdk-reference.pages.dev/) to help you get familiar with the available methods and classes.\n\n## ✨ Upgrading from 1.x\n\nSee [UPGRADE.md](UPGRADING.md) for instructions on upgrading from 1.x to 2.x.\n\n**Note**: The Kotlin/Java SDK 2.x is not compatible with the Nylas API earlier than v3-beta.\n\n## 🪵 Logging\n\nThe SDK uses [SLF4J](http://www.slf4j.org) for logging. If you are using the SDK you can [choose what logging framework to use with it](http://www.slf4j.org/manual.html#projectDep) for your app.\n\nCommon choices are log4j, logback, java.util.logging. If the application doesn't specify any logging framework,\nSLF4J emits one single warning and is then completely silent.\n\nBy default, the HTTP client is configured with the `com.nylas.HttpLoggingInterceptor`\nwhich provides three DEBUG level loggers for HTTP requests.\n\n- `com.nylas.http.Summary` logs one line for each request, containing the method, URI, and content size,\nand one line for each response containing the status code, message, content size and duration.\n- `com.nylas.http.Headers` logs the request and response HTTP headers (except Authorization value by default).\n- `com.nylas.http.Body` logs request and response bodies (first 10kB by default).\n\nYou can enable or disable these loggers using whatever logging framework you use.\n\nFor example, if you're using log4j2 and with an xml configuration file, include this line to enable all three:\n`\u003cLogger name=\"com.nylas\" level=\"DEBUG\"/\u003e`\n\nYou can configure how you log HTTP Authorization header values and the body size limit using a\n`NylasClient.Builder` with a customized `HttpLoggingInterceptor`\n\n## 💙 Contributing\n\nWe value and appreciate contributors' time! We welcome questions, bug reports, and pull requests.\n\nSee the [Contributing](Contributing.md) for information about how to make contributions to this project.\n\n## 📝 License\n\nThis project is licensed under the terms of the MIT license. See the [LICENSE](LICENSE) for the full terms.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnylas%2Fnylas-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnylas%2Fnylas-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnylas%2Fnylas-java/lists"}