Fireberry icon

Fireberry

Consume Fireberry API

Actions11

Overview

The "Update Batch" operation of the Fireberry node allows users to update multiple records in a specified object type within the Fireberry system in a single batch request. This is useful when you need to modify several records at once, improving efficiency by reducing the number of API calls compared to updating records individually.

Typical use cases include:

  • Bulk updating customer information after a marketing campaign.
  • Modifying status fields for multiple orders simultaneously.
  • Applying corrections or data enrichment to many records in one go.

For example, you might update the "Status" field to "Completed" for a list of order records identified by their IDs.

Properties

Name Meaning
Object Type Name or ID The Fireberry object type to update records in. Choose from a dropdown list or specify an ID via expression.
Records JSON array of records to update. Each record must have an id (record ID) and a record object containing field-value pairs to update. Format example: [{"id": "recordId", "record": {"FieldName": "New Value"}}].

Output

The output contains a JSON object representing the result of the batch update operation. Typically, this includes confirmation of updated records or any returned metadata from the Fireberry API about the update process.

The node does not explicitly mention binary data output for this operation.

Dependencies

  • Requires an active connection to the Fireberry API using an API key credential configured in n8n.
  • The node depends on Fireberry's REST API endpoints to perform batch updates.
  • The "Object Type Name or ID" property relies on dynamically loaded options fetched from Fireberry to select valid object types.

Troubleshooting

  • Invalid Object Type: If the specified object type does not exist or is misspelled, the node will fail. Ensure the object type is selected from the provided list or correctly specified via expression.
  • Malformed Records JSON: The "Records" input must be a properly formatted JSON array with each element containing an id and a record object. Invalid JSON or missing required fields will cause errors.
  • API Authentication Errors: Missing or invalid API credentials will prevent successful communication with Fireberry.
  • Partial Failures: If some records fail to update due to validation errors or permissions, the node may throw errors unless "Continue On Fail" is enabled, which will return error details per failed item.
  • Error Messages: Common error messages relate to unsupported operations, invalid parameters, or API response errors. Review the message content for hints and verify inputs accordingly.

Links and References

Discussion