Getting started

1

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

To register, you just need to fill out the form below 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.



2

Create your app

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

This is your developer portal where you manage your integrations.

You can then create test environments where you can connect your integrations and test them. (See information in step 3)

 

In the Fortnox developer portal you can create and manage your apps that the Fortnox user can use to connect Fortnox to your system.

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

Skapa ny app
3

Create your test database

We provide test databases for you to try out your code in a safe environment before connecting your live customers.
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

4

Connect your integration manually

In Fortnox you now have to 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”.

admin-ajax
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.

Authorisation code

Each Fortnox account need both a unique Authorization-Code and a unique Access-Token. That means that your integration needs to be able to manage a unique set of keys for every Fortnox account that is connected.

5

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 thirty days before becoming invalid and can only be used once to retrieve the Access-Token.
If the Authorization-Code is used again after an Access-Token has been retrieved the Authorization-Code will become invalid and the integration will become deactivated. The Access-Token does not have a time limit and will be valid until it is deactivated.

The Access-Token combined with the Client-Secret is unique for your application and connects to a specific Fortnox account.

To retrieve your Access-Token you simply send a request to our API using the headers “Authorization-Code” and “Client-Secret”.

Here’s an example using cURL

curl -X "GET" "https://api.fortnox.se/3/customers" \
     -H "Authorization-Code: 03b8d2b5-cade-c544-7a59-5a1ac8665856" \
     -H "Client-Secret: BFr3jKKZ1J" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json"

For more information about authentication, follow this link.

6

Making your request

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

The same example as before using cURL but with the header corrected

curl -X "GET" "https://api.fortnox.se/3/customers" \
     -H "Access-Token: 895gh5t-rt65-t43r-8r99-56847hty54ju" \
     -H "Client-Secret: BFr3jKKZ1J" \
     -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!