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.
How to use a technical access
How to use REST APIs
To use magnews REST APIs, include the access token in the header:
Authorization: Bearer {access_token}
For details on how to use the refresh token and for more information, refer to the REST API documentation.
How to access the SFTP space
To connect to the SFTP space, use:
Username:
oauthPassword: access token
Learn more about FTP access with the OAuth Client certificate.
How to use Simply SMTP
To send emails via Simply SMTP, use the credentials generated with the technical access.
Refer to the dedicated guide for SMTP configuration parameters.