The monday.com SDK provides a toolset for application developers to build features and solutions on top of the monday.com Work OS platform. You'll find this SDK useful if you want to:
Access monday.com account data from your application by utilizing the GraphQL client
Build board views and dashboard widgets that extend the monday.com UI
Build integrations and automations using your own external services and business logic
The SDK contains methods for server-side and client-side application development. Client-side capabilities assume a valid user session is present and can seamlessly act on behalf of that user. At the same time, you can use server-side methods to access monday.com features using explicit credentials without any client-side code.
## Using as an `
Install the SDK as a module:
npm install monday-sdk-js --save`
Then import into your project:
## As a `
<script>` tag directly in your HTML code
Load the SDK directly into your HTML code by adding the following:
Then, initialize the SDK anywhere on the page by declaring:
const monday = window.mondaySdk()`
# Seamless authentication
When used for client-side development, SDK methods that require acting on behalf of the connected user will work out-of-the-box by communicating with the parent monday.com running application. You're not required to initialize the SDK client with any explicit credentials.
Methods that use seamless authentication (including `
monday.api` and `
monday.storage`) offer capabilities that are scoped based on the permissions of the logged-in user and the scopes you have configured in your app.
# SDK capabilities
The SDK exposes the following capabilities:
|<a href="https://developer.monday.com/apps/docs/mondayapi" target="_blank">`||Performing queries against the monday.com API on behalf of the connected user|
|<a href="https://developer.monday.com/apps/docs/mondaylisten" target="_blank">`||Listen to client-side events on the monday.com client running this app|
|<a href="https://developer.monday.com/apps/docs/mondayget" target="_blank">`||Retrieve information from the monday.com client running this app|
|<a href="https://developer.monday.com/apps/docs/mondayexecute" target="_blank">`||Call an action on the monday.com client running this app|
|<a href="https://developer.monday.com/apps/docs/mondaystorage" target="_blank">`||Read/write to the Storage API, a key-value storage service for apps|
|<a href="https://developer.monday.com/apps/docs/mondayset" target="_blank">`||Setup data inside an app|
# Typescript support
You can find the type declaration for each SDK method in the `
types/index.d.ts` <a href="https://github.com/mondaycom/monday-sdk-js" target="_blank" rel="_nofollow">file</a>. TypeScript support is only available in SDK versions 0.3.0 and later.
Join our developer community!
We've created a <a href="https://community.monday.com/c/developers/8" target="_blank"> community</a> specifically for our devs where you can search through previous topics to find solutions, ask new questions, hear about new features and updates, and learn tips and tricks from other devs. Come join in on the fun! 😎