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

# Curve Setup

> Enter credentials, test the connection, activate, and configure contract name format

## Prerequisites

* A Curve account with API access (Label and/or Publisher).
* Your Curve API credentials: Application Token, API Key, API Secret Key, and Client ID.

You can enter credentials for **Label**, **Publisher**, or both. Each account type has its own credentials and can be enabled or disabled independently.

## Entering Credentials

In **Project Settings** → **Integrations** → **Curve** → **Settings** → **Credentials**:

1. Select **Label** or **Publisher** in the sidebar.
2. Enter the four credential fields:
   * **Application Token**
   * **API Key**
   * **API Secret Key**
   * **Client ID**
3. Use the show/hide toggle next to secret fields if you need to confirm what you entered.
4. Click **Save & Test** to store the values and validate the connection with Curve’s API.

If the test succeeds, you can proceed to activate. If it fails, check that the credentials are correct and that your Curve account allows API access.

## Activating the Connection

After a successful **Save & Test**:

1. Click **Activate** for that account type (Label or Publisher).
2. The connection is locked for editing; only **Deactivate** is available afterward.
3. Activating triggers an **initial scan** that attempts to match Royaltyport entities to Curve payees, catalog to Curve releases/tracks, and contracts to Curve contracts.

Once activated, the **Links** tab will show the results of that scan so you can review and complete linking before running syncs.

## Enabling and Disabling

Each account type (Label / Publisher) has an **Enabled** switch. You can disable an account type without deactivating or clearing credentials. When disabled, that account type is not used for syncs or linking until you enable it again.

## Contract Name Format

Under **Settings** → **Format** → **Contract Name**, you can configure how contract names are generated when creating or updating contracts in Curve. Options typically include:

* A **static prefix or pattern** plus **extractor fields** (e.g. contract type, assignee name, date).
* A **delimiter** between parts (space, underscore, or hyphen).

Configure this before running syncs so new Curve contracts get consistent, recognizable names.

## Next Steps

<Card title="Linking Overview" icon="link" href="/projects/settings/integrations/curve/linking-overview">
  Complete linking in the recommended order before syncing.
</Card>

<Card title="Linking Entities" icon="users" href="/projects/settings/integrations/curve/linking-entities">
  Link Royaltyport entities to Curve payees first.
</Card>