Actions31
- Option Set Actions
- Public Query Actions
- Record Actions
- Role Actions
- Workflow Actions
- Worksheet Actions
Record → Create
AI-generatedOverview
This node interacts with the Hyper Application Platform (HAP) API to create a new record in a specified worksheet. It is useful when you want to programmatically add data entries into a HAP worksheet as part of an automated workflow. For example, you might use this node to insert form submission data, import external data sources, or log events into a HAP application.
Properties
| Name | Meaning |
|---|---|
| Worksheet ID | The unique identifier of the worksheet where the new record will be created. |
| Fields | An array of objects specifying the fields to set on the new record. Each object includes an ID for the field and its corresponding value. Example: [{"ID": "field_id", "value": "field_value"}]. |
| Trigger Workflow | Boolean flag indicating whether to trigger any associated workflows after the record creation. Options: true or false. |
Output
The node outputs JSON data representing the newly created record. This typically includes the record's unique identifier and the values of the fields that were set. The output can be used downstream in the workflow for further processing or conditional logic.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential to authenticate with the HAP API.
- The node expects network access to the HAP service endpoint.
- No additional environment variables are explicitly required beyond the API authentication.
Troubleshooting
Common Issues:
- Invalid or missing Worksheet ID: Ensure the worksheet ID provided exists and is accessible with the given credentials.
- Malformed Fields JSON: The fields property must be a valid JSON array of objects with correct
IDandvaluekeys. - Permission errors: The API key must have sufficient permissions to create records in the target worksheet.
Error Messages:
- "Unauthorized" or "Authentication failed": Check that the API key credential is correctly configured and valid.
- "Worksheet not found": Verify the worksheet ID is correct and the worksheet exists.
- "Invalid fields format": Confirm the fields input is a properly formatted JSON array matching expected structure.
Resolving these usually involves verifying input parameters and ensuring proper API credentials.