@frontic/n8n-nodes-ingest
v0.2.0
Published
Frontic n8n node for sending data to the Frontic Ingest API
Keywords
Readme
n8n-nodes-frontic
This is an n8n community node. It lets you use Frontic Ingest API in your n8n workflows.
Frontic is a data ingestion and synchronization platform that allows you to send data to your Frontic project through RESTful API endpoints. The Frontic Ingest Node enables you to seamlessly integrate Frontic's data ingestion capabilities into your n8n automation workflows, allowing you to upsert or delete data records programmatically.
n8n is a fair-code licensed workflow automation platform.
Installation
Operations
Credentials
Compatibility
Usage
Resources
Installation
Follow the installation guide in the n8n community nodes documentation.
Operations
The Frontic Ingest Node supports the following operations:
Upsert: Send data to Frontic's upsert endpoint to create or update records in your Frontic project. The node accepts input data from previous nodes in your workflow and sends it as a JSON array to the configured upsert endpoint.
Delete: Send data to Frontic's delete endpoint to remove records from your Frontic project. Similar to upsert, it processes input data and sends it to the configured delete endpoint.
Credentials
To use the Frontic Ingest Node, you need to authenticate with Frontic using an API key.
Prerequisites
- You need a Frontic account and project
- You need to create an Ingest API key in your Frontic project settings
Setting up credentials
- In your n8n workflow, add the Frontic Ingest Node
- Click on the credentials field and select "Create New"
- Navigate to your Frontic Settings to create a new Ingest API key
- Copy the API key and paste it into the "API Key" field in the credentials form
- Save the credentials
The API key will be automatically included in the Authorization header of all requests made to Frontic's Ingest API.
Compatibility
- Minimum n8n version: Compatible with n8n workflows that support n8n Nodes API version 1
- Node version: 1.0.0
Usage
Configuring the Node
Upsert Endpoint: Enter your Frontic upsert endpoint URL. You can find this endpoint in your integration feed setup in the Frontic dashboard. The format is typically:
https://ingest-<project-id>.frontic.com/ingest/<feed-id>/upsertDelete Endpoint: Enter your Frontic delete endpoint URL. Similar to the upsert endpoint, you can find this in your integration feed setup. The format is typically:
https://ingest-<project-id>.frontic.com/ingest/<feed-id>/deleteIngest Operation: Select the operation you want to perform:
- Upsert: To create or update records
- Delete: To remove records
How It Works
The Frontic Ingest Node processes data from previous nodes in your workflow:
- Input Processing: The node collects all input items from the previous node(s) in your workflow
- Data Transformation: Each input item's JSON data is extracted and added to an array
- API Request: The node sends a POST request to the selected endpoint (upsert or delete) with the array of data as the request body
- Response: The API response is returned and can be used by subsequent nodes in your workflow
Example Workflow
A typical use case might involve:
- Fetching data from a source (e.g., a database, API, or file)
- Transforming the data using n8n's data transformation nodes
- Using the Frontic Ingest Node to send the transformed data to Frontic
- Processing the response or triggering additional actions
The node accepts any JSON data structure, making it flexible for various data formats and use cases.
Resources
Test the node
To test the node, follow these steps:
Install n8n globally
npm install n8n -gPublish the node locally (inside the n8n-nodes-frontic directory)
npm run build npm linkInstall the node in n8n (inside the n8n directory)
cd ~/.n8n/custom npm link n8n-nodes-fronticStart n8n
n8n start
Troubleshooting:
If the directory ~/.n8n/custom does not exist, start n8n once (this will create ~/.n8n) and then run
# Inside the ~/.n8n directory
mkdir custom
cd custom
npm initand continue with step 3.
