> For the complete documentation index, see [llms.txt](https://docs.silkline.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.silkline.ai/configuration/integrations/managing-integrations.md).

# Managing Integrations

How to create, edit, and manage integrations in Silkline

## Overview

Silkline integrations allow you to sync data between Silkline and your existing systems like NetSuite, First Resonance ION, Manufacturo, and ProShop. New integrations are configured by the Silkline team; once set up, you can manage credentials and settings from the Silkline application.

## Accessing Integrations

1. Navigate to **Organization Settings** from your user menu
2. Click on the **Integrations** tab

{% hint style="info" %}
Creating and configuring a new integration requires Silkline support — contact your account executive to start the setup process. Once an integration exists, users with the **Admin** role can edit it (when RBAC is enabled).
{% endhint %}

## Creating a New Integration

To set up a new integration, contact Silkline support. Your account executive will coordinate with the Silkline team to configure the integration for your organization. Once it's been created, you can add credentials and adjust settings yourself — see [Adding Integration Secrets](#adding-integration-secrets) below.

## Adding Integration Secrets

After your integration has been set up by the Silkline team, you need to provide authentication credentials so Silkline can connect to your system.

{% stepper %}
{% step %}

#### Open the Integration Detail Page

1. From the Integrations list, click on your integration
2. Navigate to the **Secrets** section
   {% endstep %}

{% step %}

#### Submit Your Credentials

1. Click **"Add Secret"** or **"Edit Secret"**
2. A form will open with fields specific to your integration type
3. Fill in the required credentials:

{% hint style="info" %}
Refer to your integration-specific setup guide for instructions on finding these credentials in your system.
{% endhint %}
{% endstep %}

{% step %}

#### Save Credentials Securely

1. Click **"Save"** to securely store your credentials
2. Your secrets are encrypted and cannot be viewed after submission

{% hint style="success" %}
Once saved, you'll see "Secret configured" with timestamps showing when the secret was created and last updated.
{% endhint %}
{% endstep %}
{% endstepper %}

## Viewing Data Flow

The **Connected Resources** section of the Integrations page shows how data moves between your connected systems and Silkline. The default **Data flow** tab is an interactive diagram:

* Each connected integration appears on the left, with the resource types it syncs (orders, suppliers, materials, etc.) in the middle and Silkline on the right
* Arrows show the sync direction for each resource type: into Silkline (ingest), out of Silkline (writeback), or both
* Toggle **"Show disabled flows"** to also see resource types an integration supports but that are currently turned off, drawn as dashed lines

The **By resource** tab lists the same information as a per-resource summary.

## When Two Integrations Sync the Same Parts or Suppliers

If you connect more than one system that holds the same parts or suppliers, Silkline keeps **one record** for each real part or supplier rather than creating a separate copy per integration. That single record shows which systems it is linked to, and each system keeps syncing its own information into it.

Silkline decides they are the same thing by matching on:

* **Parts** — part number and revision
* **Suppliers** — supplier name

Anything that differs — a different part number, a different revision, a different spelling of a supplier name — is treated as a different record.

{% hint style="warning" %}
**When Silkline can't tell which record to use**

Some systems hold several different parts under one part number. NetSuite does this, for example, by item type: an inventory part and a service item can share a number.

If Silkline finds more than one existing record that a part or supplier could belong to, it does **not** guess. It skips that record and explains why in the record's **Sync History**. Combine the records you don't need, then run the sync again.

Only one of your connected systems can hold several parts under one part number, and likewise for suppliers. If you need two systems to do this at the same time, contact Silkline before enabling the second one.
{% endhint %}

## Editing an Integration

To modify integration settings:

1. Navigate to your integration from the Integrations list
2. Click the **"Edit"** button on the integration detail page
3. Update your configuration (display name, writeback/ingest toggles, base URL, etc.)
4. Click **"Save"** to apply changes

{% hint style="info" %}
You can update your integration secrets at any time by clicking **"Edit Secret"** in the Secrets section. This will overwrite your previous credentials.
{% endhint %}

## Next Steps

After setting up your integration and adding credentials:

1. Refer to your integration-specific guide for detailed setup instructions:
   * [First Resonance (ION)](/configuration/integrations/first-resonance-ion.md)
   * [Manufacturo](/configuration/integrations/manufacturo.md)
   * [NetSuite](/configuration/integrations/netsuite.md)
   * [ProShop](/configuration/integrations/proshop.md)
   * [Procurify](/configuration/integrations/procurify.md)
   * [Custom API Integration](/configuration/integrations/custom-api.md)
   * [HRIS](/configuration/integrations/hris.md)