Enterprise customers can now manage departments via the API. This release introduces new queries and mutations for creating, updating, assigning, and deleting departments.
departmentsdepartment field added to usersYou can now manage feature-level lifecycle event subscriptions via the API. Use get_app_lifecycle_subscriptions, update_app_lifecycle_subscription, and delete_app_lifecycle_subscription to retrieve, configure, or remove webhook subscriptions for specific app features.
👉 Read more about feature-level lifecycle event subscriptions here.
query {
get_app_lifecycle_subscriptions(app_id: "123", version_id: "456") {
id
entity_id
event_type
webhook_url
is_sync
}
}mutation {
update_app_lifecycle_subscription(
entity_identifier: "my-app::my-object-feature"
entity_type: "appFeature"
input: {
lifecycle_events: [
{
event_type: "AppFeatureObject:create"
webhook_url: "https://myapp.com/webhooks/lifecycle"
is_sync: false
}
{
event_type: "AppFeatureObject:delete"
webhook_url: "https://myapp.com/webhooks/lifecycle"
is_sync: false
}
{
event_type: "AppFeatureObject:update_attributes"
webhook_url: "https://myapp.com/webhooks/lifecycle"
is_sync: true
}
]
}
) {
id
event_type
webhook_url
is_sync
}
}mutation {
delete_app_lifecycle_subscription(
entity_identifier: "my-app::my-object-feature"
entity_type: "appFeature"
)
}You can now use the create_marketplace_app_discount mutation to create a marketplace app discount via the API. This mutation can be used for both potential and existing customers.
create_marketplace_app_discount replaces the grant_marketplace_app_discount mutation, which will be deprecated in a future release.
mutation {
create_marketplace_app_discount_offer(
app_id: "12345"
account_slug: "my-company"
discount_data: {
discount: 20
days_valid: 30
period: MONTHLY
app_plan_ids: ["plan_001"]
}
) {
granted_discount {
app_id
app_plan_ids
discount
period
}
}
}You can now use the set_item_description_content mutation to update an item’s description via the API. The description is provided as Markdown, which is then converted into document blocks that replace the item’s existing content.
mutation {
set_item_description_content(
item_id: 1234567890
markdown: "**The updated description!**"
) {
success
error
block_ids
}
}You can now use the create_project mutation to create a new project board via the API. This mutation is part of a monday.com portfolio solution and only available on Enterprise plans.
mutation {
create_project(
input: {
name: "Q1 2026 Marketing Campaign"
board_kind: public
workspace_id: "123456"
folder_id: "9876543210"
companions: ["resource_planner"]
callback_url: "https://your-domain.com/webhook/project-created"
}
) {
success
message
process_id
error
}
}You can now create up to 25 document blocks in bulk with the create_doc_blocks mutation.
mutation {
create_doc_blocks(
docId: 12345
blocksInput: [
{
text_block: {
text_block_type: QUOTE
delta_format: [
{
insert: {
text: "The best way to predict the future is to create it."
}
attributes: {
italic: true
color: "#666666"
}
}
{
insert: {
text: "Peter Drucker"
}
attributes: {
bold: true
color: "#999999"
}
}
]
}
}
{
text_block: {
text_block_type: LARGE_TITLE
delta_format: [
{
insert: {
text: "This quote highlights the power of action and ownership."
}
}
]
}
}
{
notice_box_block: {
theme: TIPS
}
}
{
list_block: {
list_block_type: BULLETED_LIST
delta_format: [
{
insert: {
text: "Set clear objectives"
}
}
]
}
}
{
list_block: {
list_block_type: BULLETED_LIST
delta_format: [
{
insert: {
text: "Take small, consistent steps"
}
}
]
}
}
{
list_block: {
list_block_type: BULLETED_LIST
delta_format: [
{
insert: {
text: "Review and adjust regularly"
}
}
]
}
}
{
page_break_block: {}
}
]
) {
doc_id
id
type
position
content {
... on TextBlockContent {
delta_format {
insert {
text
}
}
}
... on ListBlockContent {
delta_format {
insert {
text
}
}
}
}
}
}
{
"data": {
"create_doc_blocks": [
{
"doc_id": "12345",
"id": "11111111-1111-1111-1111-111111111111",
"type": "quote",
"position": 100000,
"content": [
{
"delta_format": [
{
"insert": {
"text": "The best way to predict the future is to create it."
}
},
{
"insert": {
"text": "Peter Drucker"
}
}
]
}
]
},
{
"doc_id": "12345",
"id": "22222222-2222-2222-2222-222222222222",
"type": "large title",
"position": 141250,
"content": [
{
"delta_format": [
{
"insert": {
"text": "This quote highlights the power of action and ownership."
}
}
]
}
]
},
{
"doc_id": "12345",
"id": "33333333-3333-3333-3333-333333333333",
"type": "notice box",
"position": 189875,
"content": [
{}
]
},
{
"doc_id": "12345",
"id": "44444444-4444-4444-4444-444444444444",
"type": "bulleted list",
"position": 235420,
"content": [
{
"delta_format": [
{
"insert": {
"text": "Set clear objectives"
}
}
]
}
]
},
{
"doc_id": "12345",
"id": "55555555-5555-5555-5555-555555555555",
"type": "bulleted list",
"position": 287965,
"content": [
{
"delta_format": [
{
"insert": {
"text": "Take small, consistent steps"
}
}
]
}
]
},
{
"doc_id": "12345",
"id": "66666666-6666-6666-6666-666666666666",
"type": "bulleted list",
"position": 346780,
"content": [
{
"delta_format": [
{
"insert": {
"text": "Review and adjust regularly"
}
}
]
}
]
},
{
"doc_id": "12345",
"id": "77777777-7777-7777-7777-777777777777",
"type": "page break",
"position": 412555,
"content": [
{}
]
}
]
},
"extensions": {
"request_id": "YOUR_REQUEST_ID"
}
}
Enterprise customers can now read and update Resource Directories using the new get_directory_resources and update_directory_resources_attributes APIs.
query {
get_directory_resources(team_ids:["12345", "54321"]) {
resources {
id
name
email
}
cursor
id
}
}mutation {
update_directory_resources_attributes(
attribute: SKILLS
value: ["React", "JavaScript"]
resource_ids: [12345, 54321]
) {
success
}
}We’ve added two new mutations that let you create columns attached to managed columns via the API. Attached columns inherit and sync their configuration and data from the managed column that controls them.
Creates a new dropdown column that's linked to a managed column
mutation {
attach_dropdown_managed_column(
board_id: 1234567890
managed_column_id: "f01e5115-fe6c-3861-8daa-4a1bcce2c2ce"
title: "Project Domains"
description: "This column is attached to a managed column."
settings: {
label_limit_count: 3
limit_select:true
}
) {
id
title
type
}
}Creates a new status column that's linked to a managed column
mutation {
attach_status_managed_column(
board_id: 1234567890
managed_column_id: "f01e5115-fe6c-3861-8daa-4a1bcce2c2ce"
title: "Project Status"
description: "This column is attached to a managed column."
) {
id
title
type
}
}You can now determine a monday.com account's trial status via the API using two new fields on the account object:
is_trial_expired: Returns true if the account's trial period has endedis_during_trial: Returns true if the account is currently in a trial periodquery {
account {
is_during_trial
is_trial_expired
}
}