# Connect my Pennylane account

## Prerequisites

Before starting, make sure that:

* You are an administrator of the Pennylane account
* Your API access is enabled (via an OAuth connection or access token)
* You have an active Fincome account
* You have access to the Clients, Products, Invoices, Credit Notes, Subscriptions modules

### Add a Pennylane source to your Fincome dashboard 

{% hint style="danger" %}
Not necessary if you already had the v1 API connected. In that case, simply replace the key with a new one on the existing Fincome connection.\
Go directly to the "Get my Pennylane API key" section to create your new key. 
{% endhint %}

{% @guideflow/guideflow-embed requestedUrl="<https://app.guideflow.com/player/9r2nd1uor6>" %}

### Get my Pennylane API key

To fill this field, go to your Pennylane interface and click the gear at the bottom left which opens the "Settings" menu

<figure><img src="https://2718071428-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJSBEJtmGPHCBhpT5qjeL%2Fuploads%2FW198YDw9mTpHSTyFP2Jh%2FCapture%20d%E2%80%99e%CC%81cran%202026-01-06%20a%CC%80%2012.38.35.png?alt=media&#x26;token=3041fb16-5091-4096-836d-ed9c8ba0e731" alt=""><figcaption></figcaption></figure>

Then click on "Connectivity"

<figure><img src="https://2718071428-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJSBEJtmGPHCBhpT5qjeL%2Fuploads%2FgLA7lHVMRy4kyXKnfy1r%2FCapture%20d%E2%80%99e%CC%81cran%202026-01-06%20a%CC%80%2012.39.38.png?alt=media&#x26;token=c929b662-946b-43e1-bc2c-d09e9dcedb68" alt=""><figcaption></figcaption></figure>

Click on "Developers", a menu with your access token will appear

<figure><img src="https://2718071428-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJSBEJtmGPHCBhpT5qjeL%2Fuploads%2FEbXVs6E8UjphLjKRx6SE%2FCapture%20d%E2%80%99e%CC%81cran%202026-01-06%20a%CC%80%2012.40.16.png?alt=media&#x26;token=410772b9-6202-4c10-9730-8aababfb12fa" alt=""><figcaption></figcaption></figure>

Create a new key by clicking "Generate an API token", then checking the following items:

<figure><img src="https://2718071428-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJSBEJtmGPHCBhpT5qjeL%2Fuploads%2FXrPxjuZMpIAigEJogivh%2FCapture%20d%E2%80%99%C3%A9cran%20du%202026-01-05%2009-28-36.png?alt=media&#x26;token=3b4f292f-7cbe-4afc-855b-a86747aeb43c" alt=""><figcaption></figcaption></figure>

At the bottom of the page, be sure to choose "unlimited" for the expiration date, and check the box below.&#x20;

<figure><img src="https://2718071428-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJSBEJtmGPHCBhpT5qjeL%2Fuploads%2FQvZtG9JuJl41BFdiqmgn%2Fcapture-decran-2026-01-06-a-10_1xn7b26.png?alt=media&#x26;token=a5716eb1-1560-49ec-bdef-9e7282599d3d" alt=""><figcaption></figcaption></figure>

Confirm and copy the key

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/620ea71851239000/image_106rgpc.png" alt="trouver clé API Pennylane, paramètres dans interface Pennylane, accéder menu Connectivité, ouvrir menu Développeurs, récupérer token d&#x27;accès, copier clé API, entrer clé API Fincome, MRR à partir de Pennylane, dates d&#x27;imputation factures, module d’Abonnements pour MRR, date d’émission comme début période, fréquence pour fin période, définir périodicité dans Plans, section Données, changer facture ponctuelle en récurrente."><figcaption></figcaption></figure>

You can now paste your API key into the "API Key" field of the Fincome interface.

***

## *Bonus: How is your MRR calculated from your Pennylane data?*&#x20;

#### Case #1: you use posting dates on your Pennylane invoices

In that case, those dates will be the ones used to account for MRR.

#### Case #2: you use the "Subscriptions" module

In that case, the invoice issue date will be considered the start date of the subscription period. The subscription frequency allows us to determine the end date of the period.

#### Case #3: set periodicity on plans

You can set a plan's periodicity from the "Data" > "Plans" section

{% hint style="info" %}
In any case, you can modify an invoice line to convert it from "One-off" to "Recurring"
{% endhint %}