Join us at Fortnox App Market today!

Developer Portal

Developers Integration Dictionary

During the process of creating your integration you will bump into these words and functions.

Developer Portal

In the developer portal, you have the possibility to create your own apps that customers can add to their companies in Fortnox. This requires you to have a developer license in Fortnox and to have a user set up with the correct permissions.

The developer license is added to your account by Fortnox.

If you are already registered as a developer you must be migrated to the new system towards a live company in Fortnox. If you do not have a live company in Fortnox before, this happens automatically when we create a company for you. 

All new registrations get this feature.

To reach the portal, please select Menu – Developer Portal.

 

My Apps

An App is an integration that customers can use to connect your system to Fortnox.

The App has a Client-Id and a Client-Secret that is used in the connection process.

To create an app, click on “Create new app”.

 

Create app

When you create your App, you must enter a name and select the scopes that the app should have access to.

Once the app is created, you can set information such as contact, routes, price for your connection and link customers to your own website.

 

Image management

You can add a logo, app icon, cover images and information about your App so that customers can easily get an idea of what the App offers.

You add an image by clicking on the field or dragging the image there.

Then place the selection as desired and press Ok.

To delete an uploaded image, there is a cross in the image field when you hold the mouse over it.

 

Redirect URI

This is the link to the landing page to get your App connected to the customer’s Fortnox account. This is where the customer can buy or activate your system and get more information about your connection. The redirect URI is also used as the callback URI during the authorization code flow.

 

Select scopes

Scope is a mechanism to limit an App’s access to a customer’s Fortnox account. An App can request one or more scopes, and the access token issued to the application will be limited to those scopes.

You can change scopes on an active connection but this does not affect already activated customers.

The connection to the customer retains the scopes your App had when the customer activated it. 

To gain access to the new scopes, the customer needs to reactivate your App.

 

Category

Here you choose under which category you want your App to be seen in the App Market. Only one choice can be made but you can change this in the future.

 

Publish app

Here you can decide if you want to publish your App so that it becomes available on App Market.

When the App is created but still hidden, customers can use your Client ID to find the App in Fortnox. This is preferable for private integrations that are not published in the App Market.

When you want to publish your App, select “Requesting publication:” with your choice and press Save. You must approve the Fortnox app partner agreement to have your app published. Fortnox will contact you and guide you through the review process required to become an app partner to Fortnox.

 

My sandboxes

We provide test environments (sandboxes) to test your code in a secure environment before connecting with your live customers.

You can create up to 30 test environments simultaneously for testing and demo purposes.

You can create and remove test environments in the developer portal.

The user in the test database is created with the same email address as the user who creates the sandbox in the developer portal.

You administer the test environments just like a regular company in Fortnox.