Skip to main content

Monday Component

Manage boards, items, and columns inside your Monday account.

Component key: monday

Description#

Monday is a Cloud-based platform that allows companies to create their own applications and work management software. The Monday component allows you to manage columns, items, and subscribers in a Monday board.

Authorization Notes#

API key#

The Monday component requires an API key to authenticate requests to the Monday GraphQL API. You can configure a Monday Personal API token from your user admin settings. For more information refer to the Monday docs

OAuth 2.0#

You can configure an OAuth 2.0 credential by registering a monday app Be sure to enter your prismatic Callback URL in the app configuration. Now, you will have to configure OAuth 2.0 settings in Prismatic. Create a new credential of type OAuth 2.0 - Authorization Code.

  • For Client ID and Client Secret enter the values that you got from your Monday app.
  • For Scopes and permission choose from the options found on the Monday docs
  • For Authorization URL enter https://auth.monday.com/oauth2/authorize
  • For Access Token URL enter https://auth.monday.com/oauth2/token

Actions#

Add Subscribers To Board#

Add the given users to the board's subscribers | key: addSubscribers

InputKeyNotesExample

Board Id

string
/ Required
boardIdProvide the unique identifier of the board

Users

string
/ Required
usersFor each item, provide the unique identifier of the user.793400

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri


Archive Board#

Delete the information and metadata of a board by Id | key: archiveBoard

InputKeyNotes

Board Id

string
/ Required
boardIdProvide the unique identifier of the board

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri


Archive Item#

Delete the information and metadata of an item by Id | key: archiveItem

InputKeyNotesExample

Item Id

string
/ Required
itemIdProvide the unique identifier of the item.098093745

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri


Create Board#

Create a new board inside your Monday account | key: createBoard

InputKeyNotesExample

Board Kind

string
/ Required
boardKindProvide a string value for the kind of board.public

Board Name

string
/ Required
boardNameProvide a string value for the name of the board.

Folder Id

string
folderIdProvide the unique identifier of the folder.

Template Id

string
templateIdProvide the unique identifier of the template that your board extends.

Workspace Id

string
workspaceIdProvide the unique identifier of the workspace.

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri


Create Column#

Create a new column inside an existing board | key: createColumn

InputKeyNotesExample

Board Id

string
/ Required
boardIdProvide the unique identifier of the board

Column Title

string
/ Required
columnTitleProvide a string value for the title of the column.Due Date

Column Type

string
/ Required
columnTypeProvide a valid column type. Chose from the list of simple and complex column types found here: https://support.monday.com/hc/en-us/articles/115005310285-What-are-the-column-choices-status

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri


Create Item#

Create a new item inside of a board | key: createItem

InputKeyNotesExample

Board Id

string
/ Required
boardIdProvide the unique identifier of the board

Column Values

string
/ Required
columnValuesProvide the unique identifier of the group your item will belong to.

Group Id

string
/ Required
groupIdProvide the unique identifier of the group your item will belong to.

Item Name

string
/ Required
itemNameProvide string value for the name of the item.exampleItem

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri


Create Update#

Create a new update with additional notes and information to add to items outside of their columns. | key: createUpdate

InputKeyNotesExample

Item Id

string
/ Required
itemIdProvide the unique identifier of the item.098093745

Parent Id

string
/ Required
parentIdProvide the unique identifier of the parent object.793400

Update Body

string
/ Required
updateBodyProvide a string value for the body of the update.This is an example update!

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri


Delete Subscribers From Board#

Remove the given subscribers from an existing board | key: deleteSubscribers

InputKeyNotesExample

Board Id

string
/ Required
boardIdProvide the unique identifier of the board

Users

string
/ Required
usersFor each item, provide the unique identifier of the user.793400

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri


Delete Update#

Delete an update of an existing item | key: deleteUpdate

InputKeyNotesExample

Update Id

string
/ Required
updateIdProvide the unique identifier of the update Id.793400

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri


Get Board#

Get the information and metadata of a board by Id | key: getBoard

InputKeyNotes

Board Id

string
/ Required
boardIdProvide the unique identifier of the board

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri


Get Columns In Board#

Get the information and metadata of all columns in a given board | key: getColumn

InputKeyNotes

Board Id

string
/ Required
boardIdProvide the unique identifier of the board

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri


Get Items By Column Value#

Get the information and metadata of an item by Column Value | key: getItemsByColumnValue

InputKeyNotesExample

Board Id

string
/ Required
boardIdProvide the unique identifier of the board

Column Id

string
/ Required
columnIdProvide the Id of the column.status

Column Value

string
/ Required
columnValueProvide the value to update the column with.Example Value

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri


List Boards#

List all available boards in your Monday account | key: listBoards

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri


List Items#

Get the information and metadata of an item by Id | key: listItems

InputKeyNotesExample

Items

string
/ Required
itemListProvide the unique identifier for each item.780497

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri


List Updates#

List all updates that have been created | key: listUpdates

InputKeyNotesExample

Update Id

string
/ Required
updateIdProvide the unique identifier of the update Id.793400

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri


Update Column Title#

Update the title of an existing column | key: updateColumnTitle

InputKeyNotesExample

Board Id

string
/ Required
boardIdProvide the unique identifier of the board

Column Id

string
/ Required
columnIdProvide the Id of the column.status

Column Title

string
/ Required
columnTitleProvide a string value for the title of the column.Due Date

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri


Update Column Value#

Update the given column value | key: updateColumnValue

InputKeyNotesExample

Board Id

string
/ Required
boardIdProvide the unique identifier of the board

Column Id

string
/ Required
columnIdProvide the Id of the column.status

Column Value

string
/ Required
columnValueProvide the value to update the column with.Example Value

Item Id

string
/ Required
itemIdProvide the unique identifier of the item.098093745

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri