Join us at Fortnox App Market today!

Get started

Developers Integration Checklist

Get started in a few simple steps today! We simplify the complex challenge with integration and we make sure that your operation runs smoothly.

Register as a developer

First of all you need to register as a developer. This is so that we know who you are and how to get in touch with you.

Developing against Fortnox API is great, you get access to Sweden’s foremost online business system and have the opportunity to reach all of our customers with your product.

As a registered developer you’ll get access to the following things

  • Your own developer portal
  • Test databases
  • Support to help you with our products and API
  • Access to our latest updates in our developer environment
  • Invitations to special events hosted by Fortnox
  • Be a part of our great developer community
  • By clicking Register, you agree that you’ve read our Change Policy.

To register, you just need to fill out the form bellow and follow the instructions.
If you have a company with your organisations number in Fortnox already then you can contact our support and they will add the developer portal to your company for free.

Click here to register

Create your app

Great, you’ve come to step 2, now you are a part of the Fortnox developer community, most welcome!

Now let’s get started!

Log in to your Fortnox account and choose “Meny” – “Utvecklarportal” to get to the developer portal.

This is your developer portal where you can manage your integrations

Now let’s focus on creating your first app! (hopefully out of many)

  • Click on the button ‘skapa app’ and see what’s happening!
  • Now for the tricky part, choose a name for your app, take your time!
  • Great, now you have to choose your scopes, scopes what is that?? ( you need to choose what part of our program you want your app to connect to, for example if you want to send data to our payroll software you choose ‘Lön’ as a scope, so figure out what scopes you need and check those boxes)
  • Last but not least press ‘Save’
  • You did it, congrats on your first app!

Now you can specify descriptive information about your app and keep track of your Client-Id and Client-Secret.

The Fortnox developer portal is where you create and manage your apps. When published, users can connect their Fortnox account to your system.

You can also create test accounts (step 3), see statistics and apply to get your app in our app market.

The developer portal is our platform for you as a developer  against our API and app market, this is where we provide news to you and add new functionality etc.

Create your test database

Now it’s time to do your first action as a developer, create your first own test database.

Try out your code in a safe environment before connecting your live customers by creating test databases.

Create up to 30 simultaneous test databases for tests and demos of your apps.

You can create and delete test databases in the developer portal.

The user in the test database will be created using the e-mail address of the user creating it in the developer portal.

Use the credentials you receive here to log in to your new test account on www.fortnox.se

Time to explore Fortnox functionality!

Connect your integration

Once logged into your test database, you can connect your integration to your Fortnox account.

You’ll find all connected integrations at the page “Administrate users” in Fortnox under the section “Integrations”.

You are also able to add new integrations here by pressing the button “Add integration”.

A window will pop up where you have the possibility to search for your integration by name or paste in your Client-Id.

A public integration will always be searchable by both the name of the integration and by using the Client-Id. A private integration will only be searchable using the Client-Id.

Select your integration and press the button “Save”.

A new window will pop up with a code called “API code”, this is an Authorization-Code. The Authorization-Code is used to retrieve the final Access-Token.

For details on how to exchange the Authorization-Code to an Access-Token, please refer to Authorization.

Authorize your application

You’ve got your Authorization-Code and your Client-Secret. These will be the keys to get the final Access-Token.

The Authorization-Code is valid for 10 minutes before becoming invalid and can only be used once to retrieve the Access-Token.

The Access-Token is retrieved by sending a POST request to the /oauth-v1/token endpoint.

Here’s an example using cURL

curl -X "POST" "https://apps.fortnox.se/oauth-v1/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -H "Authorization: Basic {Credentials}" \
     -d "code=126573b6-9233-4636-9671-a009f652fe3d" \
     -d "grant_type=authorization_code" \
     -d "redirect_uri=https://mysite.org/activation" 

For more information about authentication, please refer to Authorization.

Making your request

Wow, you’re not slowing down! 

Ok, let’s make a request.

With the Access-Token you just received you can start making requests and develop against our API.

Here’s an example using cURL

curl -X "GET" "https://api.fortnox.se/3/customers" \
     -H "Authorization: Bearer {Access-Token}" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json"

Start by going through our documentation to see which data is available and how to use it. If there are any questions, please don’t hesitate to contact us. We are here for you! 

Publishing your integration

Are you already done? You must be a great developer, you know that we are hiring right? 😉

Ok, when your software is connected to our API it’s time for you to make a decision, and it’s a big one!

You can choose to publish your app in our App Market in two different ways. Here are your options:

  • Purchasable Apps (We will offer your software to the customer to buy, read more on ‘about app market’ page)
  • Activatable Apps (you sell your app and software yourself and our App Market is just a place where your customers can activate it)

There is also a third option. If you don’t want other customers to see your app, you can publish it privately so that only you can connect it.

If there are any questions about this part don’t hesitate to contact us so that we can help you sort things out.

Read more about publishing your integration here.