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 “Menu” – “Developer portal”.

This is your developer portal where you can manage your integrations.

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

• Click on the button ‘create integration’ and see what’s happening!

• Now for the tricky part, choose a name for your integration, 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 integration 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 integration!

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

The Fortnox developer portal is where you create and manage your integrations. 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 integration published at Fortnox.

The developer portal is your go-to platform for working with our API and Integration platform. Here you’ll find updates, news, and new features designed to support you as a developer.

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 integrations.

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.

This requires that you have set ut the redirect URI in the integration 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

For more information about the authentication request, please refer to Get Authorization-Code .

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 the Access-Token request, please refer to Get Access-Token .

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}"

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 integration at Fortnox in two different ways. Here are your options:

• Purchasable integration (We make your software available for customers to purchase directly within Fortnox when they’re logged in. Your integration will also get dedicated space on the Fortnox website to help increase its visibility.)

• Activatable integration (You sell your integration and software independently, and the Fortnox platform serves as the channel where your customers can easily activate it.)

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