---
title: "Get grant settings"
method: GET
path: "/v3/grants/{grant_id}/settings"
tags: ["Manage Grants"]
---

# Get grant settings

`GET /v3/grants/{grant_id}/settings`

## Request

- Base URL: `https://api.us.nylas.com`
- URL: `https://api.us.nylas.com/v3/grants/{grant_id}/settings`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nylas/apis/nylas-api/docs/v3/grants/:grant_id/settings/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns every public setting for the grant, one key per setting. A setting that isn't set is
`null`. The response schema describes each setting.

## Response `200`

OK

- object
  - `request_id` string: The request ID.
  - `data` GrantSettingsObject: The grant's public settings. Each key is the setting name, the same as in the path. A setting that isn't set is `null`.
    - `synced-calendars` string[], nullable: The calendars that Nylas syncs and sends `calendar.*` and `event.*` notifications for on this grant, as provider calendar IDs. `null` when the grant has no list, which means the **Subscribe to primary calendars only** setting in the Dashboard applies. For how the two interact, see [Sync and notify for specific calendars](/docs/v3/calendar/#sync-and-notify-for-specific-calendars).

## Other responses

- `401`: Not Authenticated

## Changes

- **2026-10-27** `d8ee467a1e7e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nylas/apis/nylas-api/changes/v3/grants/:grant_id/settings/get.md)

---

[API](https://skmtc.dev/nylas/apis/nylas-api.md) - [All operations](https://skmtc.dev/nylas/apis/nylas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nylas/apis/nylas-api/revisions/7782a3e3ab70?raw)