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

# Ascora - How do I link my account?

## Overview

To authenticate with Ascora, you need:

1. **API Key** — an Ascora Integration Key, or your account's Company Key.

This guide will show you how to get it.

### Prerequisites

* An Ascora account where you are an Administrator. Only Administrators can open API Settings.

### Step 1: Create an Integration Key

1. Sign in to Ascora and go to **Administration** > **Integrations & API** > **API Settings**.
2. In the **Integration Keys** section, click **+ New Key**.

![Ascora API Settings page with the New Key button in the Integration Keys section](https://mintcdn.com/nango/D6kgrae1pAX6QdRA/api-integrations/ascora/api_settings_new_key.png?fit=max\&auto=format\&n=D6kgrae1pAX6QdRA\&q=85\&s=edfc2442129bc90d5d2a30c9cc6da6fb)

3. Enter a **Name** that says what uses the key, choose when it **Expires**, and tick **Read** (and **Write** if your integration needs it) for each area under **Access**. **Read everything** ticks every Read box. Then click **Save**.

![Ascora new Integration Key dialog with access options and the Save button](https://mintcdn.com/nango/D6kgrae1pAX6QdRA/api-integrations/ascora/new_integration_key_dialog.png?fit=max\&auto=format\&n=D6kgrae1pAX6QdRA\&q=85\&s=00a06b75c3414245838990028af92367)

4. Copy the key from the **Copy Your New Key** window. It starts with `ascora_` and is shown only once: if you lose it, revoke it and create a new one.

![Ascora Copy Your New Key window showing the new Integration Key](https://mintcdn.com/nango/D6kgrae1pAX6QdRA/api-integrations/ascora/copy_new_integration_key.png?fit=max\&auto=format\&n=D6kgrae1pAX6QdRA\&q=85\&s=1891d3a74c3dec67f22a6f9de8cc2827)

To use your Company Key instead, go to the **Company Key** section of the same page. If the key is not enabled yet, click **Generate New API Key**, then click **Show** or **Copy to Clipboard** to copy it. Generating a new Company Key replaces the old one.

![Ascora Company Key section with the Show, Generate New API Key and Copy to Clipboard buttons](https://mintcdn.com/nango/D6kgrae1pAX6QdRA/api-integrations/ascora/company_key_created.png?fit=max\&auto=format\&n=D6kgrae1pAX6QdRA\&q=85\&s=c990128d0404801cb591cec73dea82df)

### Step 2: Enter your API key in the Connect UI

1. Open the form where you need to authenticate with Ascora.
2. Paste the key you copied in Step 1 into the **API Key** field.
3. Submit the form. Nango checks the key with Ascora and rejects it if it is wrong, revoked or expired.

![Ascora Connect UI form with the API Key field](https://mintcdn.com/nango/D6kgrae1pAX6QdRA/api-integrations/ascora/form.png?fit=max\&auto=format\&n=D6kgrae1pAX6QdRA\&q=85\&s=d35dd85a117772bd8520d0f1e1601e67)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.