Request Oauth credentials.
To use the API Oauth credentials are required, use this page to request these credentials.
Environment credentials.Credentials are created per environment, this means that staging credentials cannot be used in production and vice versa.
Third parties already using a specific environment are required to fill out the request form again, to apply for credentials in new environment.
The same applies to change requests. A change request must be submitted for the environment that the client belongs to.
Sharing credential information.Never share the credentials with unverified parties, credential owners are responsible for safe storage and sharing procedures of the credentials.
Never share the secret key of a client with any external party.
Zenegy will never ask for the secret key of a client, if such a request is received it should be ignored and reported.
Requesting new credentials.
When requesting credentials, it is important to ensure that all required information is provided. Requests will be denied if the information provided is not valid.
Once the request has been submitted, an e-mail with the credentials or reason for denial will be sent to the contact person defined on the registration form. The e-mail is sent encrypted, as it contains sensitive information.
Requesting credentials.
To request credentials, use the form below:
The party using the credentials should fill out the form, not the end users themselves.
It is important to write the correct "application name" and "company name" in the form, as these values will be displayed during authentication.
How to fill out the form.
The form is split into steps, and you can go back and change your answers at any time before submitting.
- Company information. Enter the company name, the company identification number (CVR) and whether the application is a public or a private integration.
- Requester information. Enter the contact person that will be connected to the credentials. The e-mail address is used to send the credentials, so make sure it is valid and can receive e-mail. Only this contact person can request changes to the credentials later.
- Platform. State whether you already have access to a Zenegy account. If you do, enter your Zenegy GUID, which can be found in the URL in your browser while you are in Zenegy.
- Application. Enter the application name, a short description of its purpose, the Zenegy product or products it will use, the redirect URL or URLs (up to three) and the environment you are requesting credentials for. Zenegy Numbers and Zenegy Expense cannot be combined in the same application, but either can be combined with Zenegy Payroll.
- Scopes. Select the resources and access levels the credentials need. Only the products you selected in the previous step are shown. For each resource you can select either READ only or FULL access, not both. FULL access includes read permissions.
- Complete. Accept the terms and conditions, review your answers and submit the request. The review section lets you go back and edit any step.
For credentials, the purpose and description of the application do not have to be in-depth, but they will still be used to define the access scopes for the credentials. Only request the scopes that the integration actually needs.
Handling credentials.When requesting or handling credentials for the Zenegy API, integrators agree that all security responsibilities and credentials changes will be handled by the integrator themselves and not the customers using the integration.
Mishandling of credentials can result in closure of the client as per the terms and conditions for the API
Lost credentialsIn case of exposed or lost credentials, reach out to our support ASAP
Updated 2 days ago