Overview
The Knack node for n8n allows you to interact with the Knack API, specifically to create new records in a selected Knack object. In the context of the "Default" Resource and "Create" Operation, this node is used to add new entries (records) to a specified object within your Knack application.
Common scenarios:
- Automating data entry into Knack from other systems.
- Creating new customer, order, or inventory records based on incoming data.
- Integrating form submissions or webhook events to populate your Knack database.
Practical example:
You could use this node to automatically create a new contact record in Knack whenever a new lead is captured via a web form or another CRM system.
Properties
| Name | Meaning |
|---|---|
| Object Name or ID | The target Knack object where the new record will be created. You can select from a list or specify an object ID using an expression. |
| Fields | The data to set in the new record. This is a collection that supports multiple field types: - Text / Other: Specify field and value. - Address: Specify field and address components (Country, Street, City, etc). - Name: Specify field and name parts (Title, First, Middle, Last). |
Output
- The output is a JSON object representing the newly created record as returned by the Knack API.
- The structure of the output
jsonfield will match the fields defined in your Knack object, with keys corresponding to field names or IDs and values as provided in the input. - No binary data is produced by this operation.
Example output:
{
"json": {
"field_1": "Value",
"field_2": {
"country": "USA",
"city": "New York"
},
"field_3": {
"first": "John",
"last": "Doe"
}
// ...other fields as defined in your Knack object
}
}
Dependencies
- External Service: Requires access to a Knack account and application.
- API Key: You must configure Knack API credentials in n8n under the name
knackApi. - n8n Configuration: No additional environment variables are required beyond standard credential setup.
Troubleshooting
Common issues:
- Invalid Object or Field ID: If you provide an incorrect object or field ID, the node may fail with an error indicating the resource was not found.
- Missing Required Fields: If required fields for the Knack object are not provided, the API will return an error.
- Authentication Errors: If the API key is missing or invalid, you'll receive authentication errors.
Error messages and resolutions:
"error": "Resource not found": Check that the Object Name or ID and Field IDs are correct."error": "Missing required field": Ensure all mandatory fields for the object are included in the Fields property."error": "Unauthorized": Verify that your Knack API credentials are correctly configured in n8n.