Import Subscriptions

This article covers how to import existing subscriptions into Fenerum, typically as part of a migration from another billing system.

When you start using Fenerum you often already have customers with active subscriptions in another system. Importing those subscriptions ensures correct MRR, revenue recognition and invoicing going forward.

Before you start

To successfully import subscriptions, make sure the following data already exists in Fenerum:

• Accounts (customers):
  Each subscription must be linked to an existing account. Make sure all relevant accounts are created or imported first.
• Products / price plans:
  Subscriptions reference products, price plans or terms. Ensure your current pricing structure is configured in Fenerum so subscriptions can map correctly.

Importing subscriptions from file

The easiest way to import many subscriptions at once is to use the file-based import.

1. Go to Settings → Import data or open the Import data page.
2. In Type of import, select Subscription.
3. Download the example file to see the required schema.
4. Fill in the file with your subscription data.
5. Upload the file and confirm the import.

If there are any issues with the file (missing required fields, invalid references, wrong formats), Fenerum will show a detailed error report so you can fix the rows and try again.

Updating existing subscriptions via import

For some use cases you may want to update existing subscriptions instead of creating new ones (for example, correcting dates or quantities after an initial import).

The subscription import supports updates when your file includes the subscription identifier used by Fenerum (e.g. UUID or other unique key), otherwise it will create new subscriptions.

The typical workflow:

1. Export the subscriptions you want to adjust from Fenerum (for example via the UI or API).
2. Edit the relevant fields in Excel (for example, dates or quantity).
3. Re-import the file using the Subscription import type.
4. Verify that the affected subscriptions were updated.

Always keep a backup export before bulk-updating, so you can roll back if necessary.

Importing subscriptions via API

If you prefer a fully automated migration or need to sync subscriptions continuously from another system, you can use the API to create or update subscriptions. Visit the API documentation to learn more about the API endpoints for subscriptions.