Technical access: connect magnews to external systems in a single step

Technical accesses allow you to connect magnews to external systems and applications that need to automatically use some platform services.

For example, you can use them when:

• a website or eCommerce needs to send transactional emails through magnews

• a CRM or a business application needs to exchange data with magnews via API

• an automated process needs to import or export files via the SFTP space

• a provider or an external system needs to access magnews services

You can use a technical access for:

• magnews APIs: integrate magnews with external applications or systems

• Simply SMTP: send transactional emails using magnews as an SMTP server

• SFTP: import or export files and data via the platform’s SFTP space

In these situations, you need to configure several technical elements, such as access credentials, tokens, and certificates.

Technical accesses simplify this configuration. Instead of creating each element separately, you can generate them automatically in a single step. When you create a technical access, magnews creates and links together:

• a technical user

• an OAuth Client digital certificate

• an OAuth token

• the access credentials for the services you selected

Technical accesses

You can view all technical accesses in the section: Settings → API and integrations → Technical accesses.

Here you find the list of technical accesses created in your account. From here you can navigate between the related elements:

• Name: open the detail view

• Technical user: click to open the user profile

• Digital certificate: click to open the certificate details

• Token: click on the last characters of the token to open the token details

If this is your first technical access, the list will be empty. At the top you find the Create technical access button to create a new one.

How to create a technical access

What will you use it for?

Select one or more services for which you want to generate credentials: magnews API, Simply SMTP, SFTP.

The generated credentials will work only for the selected services, but an administrator user can later modify these specific permissions.

Assign a name

Enter a name that identifies the integration. This name will be automatically used for:

• digital certificate name

• OAuth access token name

• name and username of the technical user

You will find these elements in their respective sections of the platform.

Enter an email

Enter the email address associated with the technical user that will be created.

Redirect URL

If you are creating a technical access for a web application, you may need an OAuth redirect URL. If you don’t know it yet, you can add it later by editing the digital certificate in the section: API and integrations → Digital certificates.

Summary

After creating a technical access, you will see a summary page with some instructions.

The token and refresh token can be copied using the icon on the right.

Related elements

If you open “How to access”, you will see instructions.
If you open “More information about related elements”, you will find references to the created elements.

Digital certificate

An OAuth 2.0 certificate has been created. You can find it in: API and integrations → Digital certificates.
You can edit it and use its information to obtain a refresh token.

Token

The token is available in: API and integrations → Token management.
From here you can view or revoke it.

The access token has a limited duration and may expire. You can use the refresh token to generate a new one.

Technical user

When you create a technical access, magnews automatically creates a technical user dedicated to the integration. The user is visible in your account user list and is identified by the “technical user” badge. You can open the profile to view details or modify permissions if needed.

This type of user is designed to be used by applications, external systems, or automated processes, not by people accessing the platform. For this reason, it has some specific characteristics:

• it is identified with the technical account flag

• it cannot access the magnews backend

• its password does not expire

• it is not suspended due to inactivity

The technical user is also automatically configured with the permissions required for the services you selected when creating the technical access (API, Simply SMTP, SFTP).

This way you can immediately use the generated credentials to configure the integration.