FireberryTest icon

FireberryTest

Consume Fireberry API Test
Join our community

Actions7

Overview

This node integrates with the Fireberry API to perform various data operations on Fireberry objects. Specifically, the Create Batch operation allows users to create multiple records in a specified Fireberry object type in one request. This is useful for bulk data insertion scenarios such as importing datasets, syncing multiple entries from other systems, or batch processing new records efficiently.

For example, if you have a list of customer records stored externally, you can use this node's Create Batch operation to insert all those customers into Fireberry at once, rather than creating them one by one.

Properties

Name Meaning
Object Type Selected A hidden boolean indicating whether an object type has been selected (true if selected).
Object Type Name or ID The Fireberry object type where the batch of records will be created. Choose from a dropdown list or specify an ID via expression.
Records JSON array of records to create. Each record is an object with field names as keys and their corresponding values. Example format:
json { "data": [ { "Key": "New Value" } ] }

Output

The node outputs the result of the batch creation operation in the json output field. This typically includes information about the newly created records, such as their IDs and any metadata returned by the Fireberry API.

If the Fireberry API supports returning binary data for created records (not indicated here), it would be included accordingly, but based on the provided code and properties, the output is JSON structured data representing the created records.

Dependencies

  • Requires an active connection to the Fireberry API using an API key or authentication token configured in n8n credentials.
  • The node depends on Fireberry API endpoints to:
    • Retrieve available object types (getObjects method).
    • Create multiple records in batch (executeCreateBatchOperation method).
  • No additional external dependencies are indicated beyond the Fireberry API and its authentication.

Troubleshooting

  • Common Issues:

    • Invalid or missing object type selection: Ensure that the "Object Type Name or ID" property is correctly set and corresponds to a valid Fireberry object.
    • Malformed JSON in the "Records" property: The records must be a valid JSON array of objects; invalid JSON will cause errors.
    • API authentication failures: Verify that the API key or authentication token is correctly configured and has sufficient permissions to create records.
    • Network or API downtime: Temporary connectivity issues with Fireberry API may cause failures.

  • Error Messages:

    • "The operation \"createBatch\" is not supported!": This indicates an unsupported operation was requested; ensure the operation parameter is set to "createBatch".
    • Errors related to invalid input data or API responses will be returned in the node output if "Continue On Fail" is enabled, otherwise they will stop execution.

Links and References

Discussion