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

# Connect Eurecia with API Key – StackOne Hub

> Link a Eurecia account in the StackOne Hub using API Key. End-user guide to authorize the integration and start using Eurecia actions.

<Warning>Generating an API token requires access to the Eurécia admin area (Espace admin). If the API (web-services) section is not shown, contact Eurécia support to activate the feature.</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Generating an API token</h2>

  <p>The API Token is a persistent token that identifies the Eurécia user the integration acts as. Requests run with the rights of that user, so generate it for a user with enough rights for the data you want to sync. The Eurécia interface is in French; labels below are shown as they appear in the app.</p>

  <Steps>
    <Step title="Sign in to Eurécia">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to your <a href="https://www.eurecia.com/login" target="_blank" rel="noopener noreferrer">Eurécia account</a>.</p>

        <ul>
          <li>Open the admin area (<strong>Espace admin</strong>).</li>
        </ul>
      </div>
    </Step>

    <Step title="Open the employee sheet">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Navigate to <strong>Salariés & Utilisateurs</strong> > <strong>Fiche salarié</strong> and open the employee sheet of the user the integration will act as.</p>

        <ul>
          <li>Open the <strong>Administration</strong> tab.</li>
        </ul>
      </div>
    </Step>

    <Step title="Generate and save the token">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the <strong>API (web-services)</strong> section, click the icon to generate a new token.</p>

        <ul>
          <li>Click <strong>Valider</strong>, then save the employee sheet.</li>
          <li>Copy the generated token and store it securely for use later.</li>
          <li>Paste it into the <strong>API Token</strong> field in StackOne Hub.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Using a user profile token instead</h2>

  <p>Instead of a token for one user, you can generate a token for a user profile, so requests run with the rights of that profile.</p>

  <ul>
    <li>Navigate to <strong>Espace admin</strong> > <strong>Paramètres généraux</strong> > <strong>Fiche société</strong> and open the <strong>Paramètres</strong> tab.</li>
    <li>In the <strong>API</strong> section, click the icon to generate a new token and select the user profile that will connect to the API with it.</li>
    <li>Click <strong>valider la ligne</strong>, then save the page.</li>
    <li>At least one existing user must be attached to the selected user profile.</li>
    <li>Paste the token into the <strong>API Token</strong> field in StackOne Hub.</li>
  </ul>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Avoiding an authentication block</h2>

  <p>Eurécia temporarily blocks your IP address after several requests with an invalid token.</p>

  <ul>
    <li>After several invalid authentication attempts within 15 minutes, all authentication requests from that IP address are rejected for 60 minutes, including ones with a valid token.</li>
    <li>Double-check the token before connecting the account.</li>
  </ul>
</section>

<div data-whitelabel-hide>
  <h2>Linking the Account from the Hub</h2>

  <Steps>
    <Step title="Navigate to the Hub">
      Use one of the three <a href="/connect/managing-connectors/linking-accounts">Linking Account Methods</a> to access the Hub.
    </Step>

    <Step title="Fill out the fields">
      Fill out the following fields using details from your provider:

      <ul>
        <li><strong>API Token</strong></li>
      </ul>
    </Step>

    <Step title="Connect">
      <ul>
        <li>Click <strong>Connect</strong></li>
        <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
        <li>Once authorization is successful, you will see a confirmation popup</li>
      </ul>
    </Step>
  </Steps>

  <p>If the account linking is successful, you will see the newly linked account in your <a href="/gateway/concepts/linked-accounts">Accounts</a> page.</p>
</div>


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