integrations

Connect Granola with an API key

Connect Granola using a customer-provided API key.

Every call creates an installation, also for a key already connected, e.g. the same notes feeding a second store. To replace an existing installation's key, e.g. after it expired, use POST /v1/integrations/granola/installations/{installation_id}/reconnect instead: connecting the new key would add an installation next to the old one.

post/v1/integrations/granola/connect

Request body

api_keystring required

Granola API key

store_namestring nullable

Ingestion store name. A store that already exists is shared: every data source connected to it ingests into it, except another installation of the same account, which would ingest every item again. Without it, the account's default store, numbered past a store another installation of the account feeds. Rejected with 422 when the connect refreshes an existing installation and names a store other than its own.

new_storeboolean

Ingest into a store created for this connection: the connect fails with 409 when store_name names a store that already exists, and without store_name the default name is numbered past existing stores. Rejected with 422 when the connect refreshes an existing installation, which keeps its store.

sync_schedule_interval'off' | 'ten_minutes' | 'hourly' | 'daily' | 'weekly'

Initial periodic sync interval

account_namestring nullable

Name of the person the API key belongs to

account_emailstring nullable

Email of the person the API key belongs to

Response

The connected Granola installation

Changes

Changed in 6 of the 30 revisions of this API.9912

Sep 26, 20269c6c72afde2d1See the full diff
- ○
  added the new optional request property
  new-optional-request-property
Sep 21, 2026b12f43c90ba32See the full diff
- ●
  added the new bucket_unavailable_error enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bucket_unavailable_error enum value to the / response property for the response status
  response-property-enum-value-added
Sep 15, 2026957bf8ec8df82See the full diff
- ●
  added the new store_frozen_error enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new store_frozen_error enum value to the / response property for the response status
  response-property-enum-value-added
Sep 10, 2026adde8ecfa74f14See the full diff
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 8, 2026ce403656bc18945See the full diff
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ●
  added the new gmail enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new google_drive enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new granola enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new slack enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 7, 20261a6549d3e64d2See the full diff
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property

Full history