> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fynn.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# n8n

> Learn how to connect Fynn with n8n to automate your workflows and integrate various services.

<Frame>
  <img src="https://mintcdn.com/fynnsubscriptionbilling/1WHsrw9xV98b8NDj/images/fynn-n8n-node.png?fit=max&auto=format&n=1WHsrw9xV98b8NDj&q=85&s=8414a1397dfb6656b9a5eed70ac66cc9" width="2260" height="1128" data-path="images/fynn-n8n-node.png" />
</Frame>

n8n is an open-source workflow automation platform that allows you to connect various services and APIs with each other.

## Benefits

* **Workflow automation**: Create complex workflows that connect and automate various services to reduce manual tasks and increase efficiency.

* **Flexible integrations**: Use the Fynn API via n8n to connect Fynn with hundreds of other tools and services, including CRM systems, email marketing tools, project management software, and more.

* **Real-time synchronization**: Automate the synchronization of data between Fynn and other systems in real-time to ensure that all systems are always up to date.

* **Open Source**: n8n is open source and can be self-hosted, giving you full control over your data and workflows.

* **User-friendly interface**: n8n offers a visual, user-friendly interface that allows even non-developers to create complex automations.

* **Dedicated Fynn Node**: Use the official Fynn community node for easy and seamless integration.

## Connect n8n with Fynn

We offer a special community node for n8n that significantly simplifies integration with Fynn: `@fynnplatform/n8n-nodes-fynn`

<Steps>
  <Step title="Create or log in to n8n account">
    Create an n8n account at [n8n.io](https://n8n.io) or log in with your existing account. You can also self-host n8n if you are using the open-source version.
  </Step>

  <Step title="Install Fynn Community Node">
    Install the Fynn community node in n8n:

    * Open the n8n settings
    * Navigate to "Community Nodes"
    * Click on "Install a community node"
    * Enter the following name: `@fynnplatform/n8n-nodes-fynn`
    * Click "Install"

    <Info>
      Alternatively, you can also install the node via the command line if you self-host n8n:
      `npm install @fynnplatform/n8n-nodes-fynn`
    </Info>
  </Step>

  <Step title="Create new workflow">
    Create a new workflow in n8n by clicking "New Workflow".
  </Step>

  <Step title="Add Fynn Node">
    Add the "Fynn" node to your workflow. You can find it under "Community Nodes" > "Fynn" in the node list.
  </Step>

  <Step title="Configure Fynn Credentials">
    Configure the Fynn connection:

    * Click on "Credential to connect with" and select "Create New Credential"
    * Enter a name for the credentials (e.g., "Fynn Production")
    * Enter your API key

    <Info>
      You can find your API key in Fynn under "Settings" > "API Keys". Create a new API key if you don't have one yet. For more information, see [Create API Key](#create-api-key).
    </Info>
  </Step>

  <Step title="Configure Node">
    Select the desired operation (e.g., "Get Customer", "Create Invoice", etc.) and configure the corresponding parameters.
  </Step>

  <Step title="Test and activate workflow">
    Test your workflow by running it manually. Once everything works, you can activate the workflow so that it runs automatically.
  </Step>
</Steps>

## Alternative: Use HTTP Request Node

If you don't want to use the community node or need advanced customizations, you can also use the standard "HTTP Request" node:

<Steps>
  <Step title="Add HTTP Request Node">
    Add an "HTTP Request" node to your workflow. This node allows you to send API requests to Fynn.

    <Tip>
      You can also use the "Webhook" node to receive webhooks from Fynn and respond to them.
    </Tip>
  </Step>

  <Step title="Configure Fynn API">
    Configure the HTTP Request node with the following information:

    * **Method**: Select the appropriate HTTP method (GET, POST, PUT, DELETE) based on the desired action
    * **URL**: Use the Fynn API URL: `https://coreapi.io/v1/[endpoint]`
    * **Authentication**: Select "Generic Credential Type" and add your API key as a header:
      * **Name**: `Authorization`
      * **Value**: `Bearer [YOUR_API_KEY]`

    <Info>
      You can find your API key in Fynn under "Settings" > "API Keys". Create a new API key if you don't have one yet. For more information, see [Create API Key](#create-api-key).
    </Info>
  </Step>
</Steps>

## Example Workflows with n8n

* **Create new invoice**: Automate the creation of invoices based on certain events or data from other systems.
* **Customer synchronization**: Synchronize customer data between Fynn and other systems such as CRM or email marketing tools.
* **Webhook processing**: Receive webhooks from Fynn and process them to trigger actions in other systems.
* **Reports and analytics**: Create automatic reports by retrieving data from Fynn and storing it in other tools like Google Sheets or Notion.

## Create API Key

To connect n8n with Fynn, you need an API key. Here's how to create one:

<Steps>
  <Step title="Open settings">
    Navigate in Fynn to ["Settings" > "API Keys"](https://app.fynn.eu/settings/api-tokens).
  </Step>

  <Step title="Create new API key">
    Click "+ Create API Key" and enter a name for the API key (e.g., "n8n Integration").
  </Step>

  <Step title="Copy API key">
    After creation, the API key is displayed once. Copy it immediately and store it securely, as it cannot be displayed again later.

    <Warning>
      Keep your API key secure and do not share it with others. The API key grants access to your Fynn data.
    </Warning>
  </Step>
</Steps>

## Using Webhooks

Fynn supports webhooks that allow you to be notified in real-time about events in Fynn. You can use webhooks in n8n to respond to these events.

For more information about webhooks, see the [Webhook Documentation](/guide/webhooks/introduction).

## API Reference

For detailed information about the Fynn API, including available endpoints, request and response formats, see the [API Reference](/api-reference).
