Developers Integration Checklist

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

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.

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!

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

You’ll find all your created apps in the app market and you are able to add them by entering them pressing the button “Activate”.

This requires that you have set ut the redirect URI in the app settings.

You can also use the Authorization request manually to retreive an Authorization-Code.
Example:

GET https://apps.fortnox.se/oauth-v1/auth?client_id={Client-ID}&redirect_uri=https%3A%2F%2Fmysite.org%2Factivation&scope=companyinformation&state=somestate123&access_type=offline&response_type=code

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.

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! 

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.