Knack icon

Knack

Interact with Knack API
Join our community

Actions6

Overview

This node interacts with the Knack API to manage records within Knack objects. Specifically, for the Record - Delete operation, it deletes a record identified by its Record ID from a specified Knack object.

Typical use cases include:

  • Automating data cleanup by removing outdated or incorrect records.
  • Integrating workflows where records need to be deleted based on external triggers or conditions.
  • Managing data lifecycle in Knack applications programmatically.

Example: Automatically deleting a customer record from a Knack database when they unsubscribe from a service.

Properties

Name Meaning
Object Select the Knack object (table) from which the record will be deleted.
Record ID The unique identifier of the record to delete.
Additional Options Contains optional settings; currently supports:
- Include Field Keys: Whether to duplicate field values with a "_raw" suffix (default true).

Output

The output JSON contains:

  • success: Boolean indicating if the deletion was successful (true).
  • message: A confirmation message string, e.g., "Record deleted successfully".
  • recordId: The ID of the deleted record.
  • response: The raw response returned by the Knack API for the delete request.

No binary data is output for this operation.

Example output JSON:

{
  "success": true,
  "message": "Record deleted successfully",
  "recordId": "5f1234567890abcdef123456",
  "response": { /* raw API response object */ }
}

Dependencies

  • Requires an active connection to the Knack API via an API key credential.
  • Needs the Knack Application ID and REST API Key configured in the node credentials.
  • Uses the Knack API endpoint (default https://api.knack.com/v1) to perform operations.
  • No additional external dependencies beyond the Knack API and n8n's HTTP request helper.

Troubleshooting

Common Issues

  • Invalid Record ID: If the provided Record ID does not exist or is malformed, the API will return an error.
  • Insufficient Permissions: The API key used must have permission to delete records in the specified object.
  • Network or API Errors: Connectivity issues or API downtime can cause failures.

Error Messages and Resolutions

  • "Record not found" or similar: Verify the Record ID is correct and exists in the selected object.
  • "Unauthorized" or "Forbidden": Check that the API key has proper permissions and is valid.
  • Timeout or network errors: Ensure stable internet connection and that the Knack API is reachable.

If the node is set to continue on fail, errors will be returned in the output JSON under an error property instead of stopping execution.

Links and References

Discussion