This connector is optimized for AI agents. For the data replication connector, see Monday .
This is the full reference documentation for the Monday agent connector.
Supported entities and actions
The Monday connector supports the following entities and actions.
Entity Actions Users List , Get , Search Boards List , Get , Search Items List , Get , Search Teams List , Get , Search Tags List , Search Updates List , Get , Search Workspaces List , Get , Search Activity Logs List , Search
Users
Users List
Returns all users in the Monday.com account
Python SDK
await monday . users . 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": "users", "action": "list" }'
Users Get
Returns a single user by ID
Python SDK
await monday . users . get ( 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": "users", "action": "get", "params": { "id": "<str>" } }'
Parameters
Parameter Name Type Required Description idstringYes User ID
Users Search
Search and filter users 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 monday . users . search ( query = { "filter" : { "eq" : { "birthday" : "<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": "users", "action": "search", "params": { "query": {"filter": {"eq": {"birthday": "<str>"}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description birthdaystringUser's birthday country_codestringUser's country code created_atstringWhen the user was created emailstringUser's email address enabledbooleanWhether the user account is enabled idstringUnique user identifier is_adminbooleanWhether the user is an admin is_guestbooleanWhether the user is a guest is_pendingbooleanWhether the user is pending is_view_onlybooleanWhether the user is view-only is_verifiedbooleanWhether the user is verified join_datestringWhen the user joined locationstringUser's location mobile_phonestringUser's mobile phone number namestringUser's display name phonestringUser's phone number photo_originalstringURL to original size photo photo_smallstringURL to small photo photo_thumbstringURL to thumbnail photo photo_thumb_smallstringURL to small thumbnail photo photo_tinystringURL to tiny photo time_zone_identifierstringUser's timezone identifier titlestringUser's job title urlstringUser's Monday.com profile URL utc_hours_diffintegerUTC hours difference for the user's timezone
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].birthdaystringUser's birthday data[].country_codestringUser's country code data[].created_atstringWhen the user was created data[].emailstringUser's email address data[].enabledbooleanWhether the user account is enabled data[].idstringUnique user identifier data[].is_adminbooleanWhether the user is an admin data[].is_guestbooleanWhether the user is a guest data[].is_pendingbooleanWhether the user is pending data[].is_view_onlybooleanWhether the user is view-only data[].is_verifiedbooleanWhether the user is verified data[].join_datestringWhen the user joined data[].locationstringUser's location data[].mobile_phonestringUser's mobile phone number data[].namestringUser's display name data[].phonestringUser's phone number data[].photo_originalstringURL to original size photo data[].photo_smallstringURL to small photo data[].photo_thumbstringURL to thumbnail photo data[].photo_thumb_smallstringURL to small thumbnail photo data[].photo_tinystringURL to tiny photo data[].time_zone_identifierstringUser's timezone identifier data[].titlestringUser's job title data[].urlstringUser's Monday.com profile URL data[].utc_hours_diffintegerUTC hours difference for the user's timezone
Boards
Boards List
Returns all boards in the Monday.com account
Python SDK
await monday . boards . 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": "boards", "action": "list" }'
Boards Get
Returns a single board by ID
Python SDK
await monday . boards . get ( 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": "boards", "action": "get", "params": { "id": "<str>" } }'
Parameters
Parameter Name Type Required Description idstringYes Board ID
Boards Search
Search and filter boards 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 monday . boards . search ( query = { "filter" : { "eq" : { "board_kind" : "<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": "boards", "action": "search", "params": { "query": {"filter": {"eq": {"board_kind": "<str>"}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description board_kindstringBoard kind (public, private, share) columnsarrayBoard columns communicationstringBoard communication value creatorobjectBoard creator descriptionstringBoard description groupsarrayBoard groups idstringUnique board identifier namestringBoard name ownersarrayBoard owners permissionsstringBoard permissions statestringBoard state (active, archived, deleted) subscribersarrayBoard subscribers tagsarrayBoard tags top_groupobjectTop group on the board typestringBoard type updated_atstringWhen the board was last updated updated_at_intintegerWhen the board was last updated (Unix timestamp) updatesarrayBoard updates viewsarrayBoard views workspaceobjectWorkspace the board belongs to
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].board_kindstringBoard kind (public, private, share) data[].columnsarrayBoard columns data[].communicationstringBoard communication value data[].creatorobjectBoard creator data[].descriptionstringBoard description data[].groupsarrayBoard groups data[].idstringUnique board identifier data[].namestringBoard name data[].ownersarrayBoard owners data[].permissionsstringBoard permissions data[].statestringBoard state (active, archived, deleted) data[].subscribersarrayBoard subscribers data[].tagsarrayBoard tags data[].top_groupobjectTop group on the board data[].typestringBoard type data[].updated_atstringWhen the board was last updated data[].updated_at_intintegerWhen the board was last updated (Unix timestamp) data[].updatesarrayBoard updates data[].viewsarrayBoard views data[].workspaceobjectWorkspace the board belongs to
Items
Items List
Returns items from boards. Queries items through the boards endpoint using items_page for pagination.
Python SDK
await monday . items . list ( board_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": "items", "action": "list", "params": { "board_id": "<str>" } }'
Parameters
Parameter Name Type Required Description board_idstringYes Board ID to fetch items from
Items Get
Returns a single item by ID
Python SDK
await monday . items . get ( 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": "items", "action": "get", "params": { "id": "<str>" } }'
Parameters
Parameter Name Type Required Description idstringYes Item ID
Items Search
Search and filter items 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 monday . items . search ( query = { "filter" : { "eq" : { "assets" : [ ] } } } )
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": "items", "action": "search", "params": { "query": {"filter": {"eq": {"assets": []}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description assetsarrayFiles attached to the item boardobjectBoard the item belongs to column_valuesarrayItem column values created_atstringWhen the item was created creator_idstringID of the user who created the item groupobjectGroup the item belongs to idstringUnique item identifier namestringItem name parent_itemobjectParent item (for subitems) statestringItem state (active, archived, deleted) subscribersarrayItem subscribers updated_atstringWhen the item was last updated updated_at_intintegerWhen the item was last updated (Unix timestamp) updatesarrayItem updates
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].assetsarrayFiles attached to the item data[].boardobjectBoard the item belongs to data[].column_valuesarrayItem column values data[].created_atstringWhen the item was created data[].creator_idstringID of the user who created the item data[].groupobjectGroup the item belongs to data[].idstringUnique item identifier data[].namestringItem name data[].parent_itemobjectParent item (for subitems) data[].statestringItem state (active, archived, deleted) data[].subscribersarrayItem subscribers data[].updated_atstringWhen the item was last updated data[].updated_at_intintegerWhen the item was last updated (Unix timestamp) data[].updatesarrayItem updates
Teams
Teams List
Returns all teams in the Monday.com account
Python SDK
await monday . teams . 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": "teams", "action": "list" }'
Teams Get
Returns a single team by ID
Python SDK
await monday . teams . get ( 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": "teams", "action": "get", "params": { "id": "<str>" } }'
Parameters
Parameter Name Type Required Description idstringYes Team ID
Teams Search
Search and filter teams 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 monday . teams . search ( query = { "filter" : { "eq" : { "id" : 0 } } } )
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": "teams", "action": "search", "params": { "query": {"filter": {"eq": {"id": 0}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description idintegerUnique team identifier namestringTeam name picture_urlstringTeam picture URL usersarrayTeam members
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].idintegerUnique team identifier data[].namestringTeam name data[].picture_urlstringTeam picture URL data[].usersarrayTeam members
Returns all tags in the Monday.com account
Python SDK
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": "tags", "action": "list" }'
Search and filter tags 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 monday . tags . search ( query = { "filter" : { "eq" : { "color" : "<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": "tags", "action": "search", "params": { "query": {"filter": {"eq": {"color": "<str>"}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description colorstringTag color idstringUnique tag identifier namestringTag name
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].colorstringTag color data[].idstringUnique tag identifier data[].namestringTag name
Updates
Updates List
Returns all updates (comments/posts) in the Monday.com account
Python SDK
await monday . updates . 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": "updates", "action": "list" }'
Parameters
Parameter Name Type Required Description pageintegerNo Page number for pagination limitintegerNo Number of updates to return per page
Updates Get
Returns a single update by ID
Python SDK
await monday . updates . get ( 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": "updates", "action": "get", "params": { "id": "<str>" } }'
Parameters
Parameter Name Type Required Description idstringYes Update ID
Updates Search
Search and filter updates 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 monday . updates . search ( query = { "filter" : { "eq" : { "assets" : [ ] } } } )
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": "updates", "action": "search", "params": { "query": {"filter": {"eq": {"assets": []}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description assetsarrayFiles attached to this update bodystringUpdate body (HTML) created_atstringWhen the update was created creator_idstringID of the user who created the update idstringUnique update identifier item_idstringID of the item this update belongs to repliesarrayReplies to this update text_bodystringUpdate body (plain text) updated_atstringWhen the update was last modified
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].assetsarrayFiles attached to this update data[].bodystringUpdate body (HTML) data[].created_atstringWhen the update was created data[].creator_idstringID of the user who created the update data[].idstringUnique update identifier data[].item_idstringID of the item this update belongs to data[].repliesarrayReplies to this update data[].text_bodystringUpdate body (plain text) data[].updated_atstringWhen the update was last modified
Workspaces
Workspaces List
Returns all workspaces in the Monday.com account
Python SDK
await monday . workspaces . 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": "workspaces", "action": "list" }'
Workspaces Get
Returns a single workspace by ID
Python SDK
await monday . workspaces . get ( 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": "workspaces", "action": "get", "params": { "id": "<str>" } }'
Parameters
Parameter Name Type Required Description idstringYes Workspace ID
Workspaces Search
Search and filter workspaces 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 monday . workspaces . search ( query = { "filter" : { "eq" : { "account_product" : { } } } } )
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": "workspaces", "action": "search", "params": { "query": {"filter": {"eq": {"account_product": {}}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description account_productobjectAccount product info created_atstringWhen the workspace was created descriptionstringWorkspace description idstringUnique workspace identifier kindstringWorkspace kind (open, closed) namestringWorkspace name owners_subscribersarrayOwner subscribers settingsobjectWorkspace settings statestringWorkspace state team_owners_subscribersarrayTeam owner subscribers teams_subscribersarrayTeam subscribers users_subscribersarrayUser subscribers
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].account_productobjectAccount product info data[].created_atstringWhen the workspace was created data[].descriptionstringWorkspace description data[].idstringUnique workspace identifier data[].kindstringWorkspace kind (open, closed) data[].namestringWorkspace name data[].owners_subscribersarrayOwner subscribers data[].settingsobjectWorkspace settings data[].statestringWorkspace state data[].team_owners_subscribersarrayTeam owner subscribers data[].teams_subscribersarrayTeam subscribers data[].users_subscribersarrayUser subscribers
Activity Logs
Activity Logs List
Returns activity logs from boards. Requires a board_id parameter.
Python SDK
await monday . activity_logs . list ( board_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": "activity_logs", "action": "list", "params": { "board_id": "<str>" } }'
Parameters
Parameter Name Type Required Description board_idstringYes Board ID to fetch activity logs from
Activity Logs Search
Search and filter activity logs 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 monday . activity_logs . search ( query = { "filter" : { "eq" : { "board_id" : 0 } } } )
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": "activity_logs", "action": "search", "params": { "query": {"filter": {"eq": {"board_id": 0}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description board_idintegerBoard ID the activity belongs to created_atstringWhen the activity occurred created_at_intintegerWhen the activity occurred (Unix timestamp) datastringEvent data (JSON string) entitystringEntity type that was affected eventstringEvent type idstringUnique activity log identifier pulse_idintegerItem (pulse) ID the activity belongs to user_idstringID of the user who performed the action
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].board_idintegerBoard ID the activity belongs to data[].created_atstringWhen the activity occurred data[].created_at_intintegerWhen the activity occurred (Unix timestamp) data[].datastringEvent data (JSON string) data[].entitystringEntity type that was affected data[].eventstringEvent type data[].idstringUnique activity log identifier data[].pulse_idintegerItem (pulse) ID the activity belongs to data[].user_idstringID of the user who performed the action