Common steps to get Started with Altinn Broker

How to get started with Altinn 3 Broker, for service owners, senders and recipients

These are common steps that all roles (Service Owner, Senders and Recipients) need to complete in order to start using the Altinn Broker component.

1. Get access to scopes

altinn:broker.write - For clients sending files.
altinn:broker.read - For clients receiving files.

These scopes are maintained by Altinn and are required to be authorized for the appropriate API operations, and as such are independent of the access set by Service Owners for the specific Broker Service Resource.

To obtain access to scopes, you must submit a request to: servicedesk@altinn.no. Please include all necessary scopes in your request. For example, beyond altinn:broker-scopes, your integration may require additional scopes. You can find the complete list of available scopes here: Complete list of scopes

2. Register your Maskinporten Client with correct scopes

Use Samarbeidsportalen self-service for registration. Here’s a detailed guide.

3. Get access to specific resource

Contact the Service owner for the Broker Resource and ask for access to the Resource, supplying them with:

Organization number you will represent
System user

This will in the future be handled by System User / Resource Registry /Access Lists through GUI.

If you are a service owner creating your first Broker Service; skip to the Service Owner guide.

4. Integrate against Broker API

You are now ready to start integrating against the Broker APIs, see the developer guides for next steps.

5. Set up Event Subscriptions

In order to use events/webhooks for a Broker resource, you need to setup a subscription for the given resource.

See the developer guide for detailed instruction.