> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.fincome.co/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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 Customers, Products, Invoices, Credit notes, Subscriptions modules

# Adding a Pennylane source to your Fincome dashboard

Not necessary if you already had the v1 API connected. In that case, simply replace the key with a new one on the already existing connection in Fincome. Go directly to the "Getting my Pennylane API key" section to create your new key.

${frame}[](https://app.guideflow.com/embed/zkl8g34bop)
# Getting my Pennylane API key

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

![](https://storage.crisp.chat/users/helpdesk/website/-/e/0/f/0/e0f0bb01a8452000/fe5563ce-4ef6-46b6-8121-78dd73_1qkd8q9.png)

Then click "Connectivity"

![](https://storage.crisp.chat/users/helpdesk/website/-/4/5/5/1/4551b6e01499f000/baedbc9a-2c62-461d-b6ab-23b495_o3bpe3.png)

Click "Developers", a menu with your access token appears

![](https://storage.crisp.chat/users/helpdesk/website/-/1/b/4/5/1b458e1d7b170a00/a48a18d7-c04d-4ede-a5e0-ef6c8d_1uydjle.png)

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

![](https://storage.crisp.chat/users/helpdesk/website/-/6/2/0/e/620ea71851239000/capture-decran-2026-09-03-a-09_1qr171x.png)

At the bottom of the page, don't forget to choose "unlimited" for the expiration date, and to check the box below.

![](https://storage.crisp.chat/users/helpdesk/website/-/7/d/5/4/7d5412d431593c00/c25d292a-0dcc-46a2-bd11-bf7ff3_fsa0as.png)

Validate and copy the key

![find Pennylane API key, settings in Pennylane interface, access Connectivity menu, open Developers menu, retrieve access token, copy API key, enter Fincome API key, MRR from Pennylane, invoice allocation dates, Subscriptions module for MRR, issue date as period start, frequency for period end, set periodicity in Plans, Data section, change one-off invoice to recurring.](https://storage.crisp.chat/users/helpdesk/website/-/6/c/6/d/6c6d6191da0a5c00/c6949820-7e0d-4cca-aa0b-6c519c_111ybz6.png)

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?

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

In this case, these dates will be the ones used to take the MRR into account.

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

In this case, the invoice's issue date will be considered the subscription's period start date. The subscription frequency lets us determine the period end date.

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

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

In all cases, you can edit an invoice line to convert it from "One-off" to "Recurring"