Introduction

Welcome to the Brincr API documentation! This section will guide you through the process of setting up your Brincr account and connecting it with the Visma Developer Portal.

Please read the instructions carefully. Everything you need is here. Please also read the FAQ if you have any questions.

If you still have questions, our technical support is available to assist you exclusively via email. You can reach us on workdays from 9.00 AM CET to 12.00 AM CET. We kindly ask that you direct all technical inquiries to our email support channel for the most efficient assistance.

Step 1. Setting Up Your Brincr Account

1. Register Your Brincr Account:

   For Sandbox
   Follow these steps to set up your Brincr account in our Brincr environment:

   1. Go to sandbox-app.brincr.com/register and sign up for a new Brincr account.
   2. After registering, make sure to fill in a Chamber Of Commerce (Kamer van Koophandel) number in Miscellaneous > Settings > Company settings. This is necessary to connect with Visma Developer Portal.
    

   For Production
   The Brincr user has their own account (and should already exist).

2. Requesting API Access:

   For Sandbox
   Please fill out this form to request access to the API for your registered Brincr account.
   
   For Production
   The Brincr user should purchase an API connection through the Brincr Shop.

   Your full name:

   Your email:

   Your phone:

   What is the name of the organization you are building this integration for?

   Registered company name in Brincr environment:

   What is the main purpose of the integration?

   Any deadlines already known to go live at production?

   What endpoints do you expect to use?

   Any questions or items you need to share with us?

   Yes, I am human.

   I promise this data is the truth.

   Submit

3. Activating API Connection:

   For Sandbox:
   Once your request is approved by our API team, login to your Brincr account (Sandbox environment). You'll find a new menu item under Miscellaneous called "API User." Visit this menu item to enable the connection between your Brincr account and Visma Developer Portal.

   Click on "Activate API connection" and ensure you have received a confirmation message. If you encounter an error, ensure you've filled in the Chamber of Commerce (Kamer van Koophandel) number in your company settings (Miscellaneous > Company settings).

   For Production:
   The Brincr user has to follow the above steps and fill in the Client ID of your production application. You will create this later on.

4. Setting Up Visma Developer Portal Account:

   For Sandbox:
   Once you are finished with the previous step, check your email for a message from Visma Developer Portal and follow the instructions to register/activate your Visma Developer Portal account.

   Create your Visma Developer Portal account, set your password, provide consent, and fill in your company information.

   Upon successful completion, you'll be redirected to the Visma Developer Portal.
   

   For Production:
   The Brincr user should follow the steps mentioned above.

   For developers:
   Please create a generic account specifically meant for you, without any references to the Brincr user for whom the application is being developed. This way you can use the account for multiple API integrations.
   For Production: do this via the Production Visma Developer Portal

   When creating a new application on the Visma Developer Portal, make sure to use this account!