Perform a GraphQL API call in Monday.com. Please refer to the API documentation for more details on configuration.
Note: You must install the Wrk App to your monday.com account before you can connect your account. To do so open this link then follow the instructions to install.
Application
monday.com
Inputs (what you have)
Name | Description | Data Type | Required? | Example |
Monday.com API Endpoint | The URL of the API endpoint to access | Link | Yes | |
GraphQL query | The query to be sent to the GraphQL endpoint | Text (Long) | Yes |
|
File | A file to be included in the request | File | No |
|
File variable name | The name of the variable where the file will mapped to in the GraphQL query. See configuration details below. | Text(Short) | No | file |
API-Version | Specific version of the API to be used | Text(Short) | No | 2024-01 |
Note: the value of inputs can either be a set value in the configuration of the Wrk Action within the Wrkflow, or a variable from the Data library section. These variables in the Data library section are the outputs of previous Wrk Actions in the Wrkflow.
Outputs (what you get)
Name | Description | Data Type | Required? | Example |
Response status code | The HTTP status code returned in the response | Integer | Yes | 200 |
Response headers | Additional information provided in the response headers | Text (Long) | Yes | Content-Type: application/json |
Response body | The main content of the response | Text (Long) | Yes | {"message": "Success"} |
Note: The "Fields to Capture" input feature can be used to create new outputs for the Wrk Action with the value of the corresponding key name in the first-level JSON output of the Wrk Action.
Example: If the "Response Body" output is equal to {"message": "Success"} Then you are able to add a "Fields to capture" input with the name "message" that will add an output to the Wrk Action called "message" which will have the value "Success"
Outcomes
Name | Description |
Success | This status is selected in the event of that the API call returns with a status between 200-399 |
Unsuccessful | This status is selected in the event of that the API call returns with a status of 400+ |
Impossible to Complete | This status is selected in the event of the following scenario:
|
Configuring File Based API Calls
When uploading a file through the monday.com API, your GraphQL query must define a File variable and reference it inside the mutation.
To ensure the file attaches correctly, the File variable name in your inputs must exactly match the variable name used in the GraphQL query.
Example Configuration
GraphQL query:
mutation ($file: File!) {
add_file_to_column(
item_id: 7550928591
column_id: "file_mkx78msw"
file: $file
) {
id
}
}File variable name:
file
File:
Upload or map a file from a previous step (for example: Step Launch - myfile).
How It Works
The File variable name connects the uploaded file to the
$filevariable declared in your GraphQL query.Wrk automatically constructs a multipart/form-data request using the variable name you provide.
If the name does not match, monday.com will return an error such as
Variable "$file" of required type "File!" was not provided.
✅ Correct Example
Input Field | Example Value |
GraphQL query | mutation ($file: File!) { add_file_to_column( item_id: 7550928591 column_id: "file_mkx78msw" file: $file ) { id } }
|
File variable name |
|
File |
|
⚠️ Common Mistakes
Issue | Example | Fix |
Variable name mismatch | Query uses | Change file variable name to |
Missing variable in query | Query omits | Add |