Perform an API call in Notion.
Note: When adding your Connected Account you will be asked which pages of your Notion you would like to add the Wrk integration to. If you have already done this and would like to add more pages please follow the instructions at the bottom of this page.
Application
Notion
Inputs (what you have)
Name | Description | Data Type | Required? | Example |
Endpoint | The URL of the API endpoint to access | Text (Long) | Yes | |
Method | The HTTP method to be used for the request | Predefined Choice List | Yes | GET |
Request headers | Additional headers to include in the request in JSON format | Text (Long) | No | {"Content-Type": "application/json"} |
Request body | The data to be included in the request body | Text (Long) | No | {"name": "John", "age": 25} |
File | A file to be included in the request | File | No | example.png |
Autopaginate | Whether to automatically retrieve and combine paginated results | True/False | No |
|
Max results | The maximum number of results to retrieve | Integer | No |
|
Results JSONPath | The path to the results in the response body | Text(Short) | No |
|
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"} |
Downloaded file | A file that is downloaded as part of the response | File | Yes | example.pdf |
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:
|
How to add the Wrk Integration to additional pages in your Notion
Open the "Manage connections" pop up
2. From "My connections" open the 3-dot menu next to "Wrk-Integration". Select "Access selected pages". Select any new pages you would like to add. Click "Update access"
