Granola full reference
This is the full reference documentation for the Granola agent connector.
Supported entities and actions
The Granola connector supports the following entities and actions.
Notes
Notes List
Returns a paginated list of meeting notes
Python SDK
await granola.notes.list()
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "notes",
"action": "list"
}'
Parameters
| Parameter Name |
Type |
Required |
Description |
page_size |
integer |
No |
Maximum number of notes to return per page |
cursor |
string |
No |
Pagination cursor for next page |
created_before |
string |
No |
Return notes created before this date (YYYY-MM-DD) |
created_after |
string |
No |
Return notes created after this date (YYYY-MM-DD) |
Records
| Field Name |
Type |
Description |
id |
string |
|
object |
string | null |
|
title |
string | null |
|
owner |
object | any |
|
created_at |
string | null |
|
updated_at |
string | null |
|
calendar_event |
object | any |
|
attendees |
array | null |
|
attendees[].name |
string | null |
|
attendees[].email |
string | null |
|
folder_membership |
array | null |
|
folder_membership[].id |
string |
|
folder_membership[].object |
string | null |
|
folder_membership[].name |
string | null |
|
summary_text |
string | null |
|
summary_markdown |
string | null |
|
transcript |
array | null |
|
transcript[].speaker |
object | any |
|
transcript[].text |
string | null |
|
transcript[].start_time |
string | null |
|
transcript[].end_time |
string | null |
|
Meta
| Field Name |
Type |
Description |
cursor |
string | null |
|
has_more |
boolean |
|
Notes Get
Get a single note by ID, including full details and optionally the transcript
Python SDK
await granola.notes.get(
note_id="<str>"
)
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "notes",
"action": "get",
"params": {
"note_id": "<str>"
}
}'
Parameters
| Parameter Name |
Type |
Required |
Description |
note_id |
string |
Yes |
The ID of the note |
include |
"transcript" |
No |
Include the note transcript in the response |
Records
| Field Name |
Type |
Description |
id |
string |
|
object |
string | null |
|
title |
string | null |
|
owner |
object | any |
|
created_at |
string | null |
|
updated_at |
string | null |
|
calendar_event |
object | any |
|
attendees |
array | null |
|
attendees[].name |
string | null |
|
attendees[].email |
string | null |
|
folder_membership |
array | null |
|
folder_membership[].id |
string |
|
folder_membership[].object |
string | null |
|
folder_membership[].name |
string | null |
|
summary_text |
string | null |
|
summary_markdown |
string | null |
|
transcript |
array | null |
|
transcript[].speaker |
object | any |
|
transcript[].text |
string | null |
|
transcript[].start_time |
string | null |
|
transcript[].end_time |
string | null |
|
Notes Search
Search and filter notes records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.
Python SDK
await granola.notes.search(
query={"filter": {"eq": {"id": "<str>"}}}
)
API
curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "notes",
"action": "search",
"params": {
"query": {"filter": {"eq": {"id": "<str>"}}}
}
}'
Parameters
| Parameter Name |
Type |
Required |
Description |
query |
object |
Yes |
Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or |
query.filter |
object |
No |
Filter conditions |
query.sort |
array |
No |
Sort conditions |
limit |
integer |
No |
Maximum results to return (default 1000) |
cursor |
string |
No |
Pagination cursor from previous response's meta.cursor |
fields |
array |
No |
Field paths to include in results |
Searchable Fields
| Field Name |
Type |
Description |
id |
string |
The unique identifier of the note. |
object |
string |
The object type, always "note". |
title |
string |
The title of the note. |
owner |
object |
The owner of the note. |
created_at |
string |
The creation time of the note in ISO 8601 format. |
updated_at |
string |
The last update time of the note in ISO 8601 format. |
summary_text |
string |
Plain text summary of the note. |
summary_markdown |
string |
Markdown formatted summary of the note. |
attendees |
array |
The attendees of the meeting. |
calendar_event |
object |
Associated calendar event details. |
folder_membership |
array |
The folder membership of the note. |
transcript |
array |
Transcript of the meeting. |
| Field Name |
Type |
Description |
data |
array |
List of matching records |
meta |
object |
Pagination metadata |
meta.has_more |
boolean |
Whether additional pages are available |
meta.cursor |
string | null |
Cursor for next page of results |
meta.took_ms |
number | null |
Query execution time in milliseconds |
data[].id |
string |
The unique identifier of the note. |
data[].object |
string |
The object type, always "note". |
data[].title |
string |
The title of the note. |
data[].owner |
object |
The owner of the note. |
data[].created_at |
string |
The creation time of the note in ISO 8601 format. |
data[].updated_at |
string |
The last update time of the note in ISO 8601 format. |
data[].summary_text |
string |
Plain text summary of the note. |
data[].summary_markdown |
string |
Markdown formatted summary of the note. |
data[].attendees |
array |
The attendees of the meeting. |
data[].calendar_event |
object |
Associated calendar event details. |
data[].folder_membership |
array |
The folder membership of the note. |
data[].transcript |
array |
Transcript of the meeting. |
tools-only