Knowledge base

This guide explains how to create a token, or API key (also known as a token) for the Infomaniak Newsletter tool.

Obtaining a token

To obtain a Newsletter API key:

1. Click here to access the management interface for your product in the Infomaniak Manager (need help?).
2. Click directly on the domain name assigned to the product in question.
3. Click on API Key in the left-hand menu.
4. Click on the blue Generate a key button:
   
5. Click on the blue Create a token button:
   
6. Select the appropriate product from the drop-down menu.
7. Choose a validity period.
8. Click on the blue Create a token button:
   
9. Enter the login password for the Manager as requested.
10. Copy the token and store it in a safe place – it will no longer be accessible afterward.

Refer to the Newsletter API documentation.

This guide explains how to receive an email notification when a new subscriber joins your Newsletter via one of your contact forms.

Be Notified When a New Contact Subscribes

To access your Newsletter:

1. Click here to access the Newsletter management in the Infomaniak Manager (need help?).
2. If necessary, click on the domain name concerned in the table that appears:
   
3. The Newsletter interface appears.

Then, to access the Newsletter subscription form:

1. Click on Forms in the left-hand menu.
2. Create or edit the form for which you want to track subscriptions:
   
3. At the very bottom of the page, check the box Receive an email when a new subscription is made.
4. Click on the blue Save button to validate the changes:
   

You will now receive an email as soon as a contact subscribes to your Newsletter via this subscription form.

Simply uncheck the box at any time to stop receiving email notifications.

This guide explains how to create and manage your authentication tokens to interact with the Infomaniak API securely.

Preamble

• Token features:
  • Number: no limit on creation
  • Validity: unlimited by default (customizable upon creation)
  • Inactivity: a token is automatically deactivated if it is not used for a year
• Usage example:
  • Token for the Newsletter API

Manage API tokens

When creating, you must define the application and the access scope:

1. Access token management on the Manager (need help?).
2. Click on Create a token:
   
3. Select the product/application and the validity period:
   
4. Confirm the operation with your account password.
5. Important: copy the token and keep it in a safe place; it will no longer be displayed afterwards.

To delete, select them and click on the revocation button that appears:

This guide explains how to manage the forms used to subscribe to the Newsletter that you manage on Infomaniak.

Prerequisites

• Have access to the Newsletter product.
• Have created at least one subscription form.

Copy the code needed to integrate the form

To access your Newsletter forms and obtain the integration code:

1. Click here to access the management interface for your product in the Infomaniak Manager (need help?).
2. Click directly on the domain name assigned to the product in question.
3. Click on Forms in the left-hand menu.
4. Click on the action menu ⋮ to the right of the item in question in the table that appears.
5. Click on Embed Code:
   
6. Choose between the JAVASCRIPT and HTML tabs to obtain one of the two types of code useful for inserting your form on your pages, and click on the blue button to copy the code to the clipboard:
   

Insert the form on a website…

You can insert the same form in different locations. You can also create multiple forms (to populate different contact groups, for example). Obviously, a newsletter is only sent once per contact, even if that contact is present in different lists/groups:

… with WordPress

1. Insert a new HTML block at the desired location:
   
2. Paste the HTML or JAVASCRIPT code obtained in step 6 above and save:
   
3. The form configured previously will be displayed on your site:
   

… with Infomaniak Site Creator

1. Hover over the desired location on the page to display a PLUS button, allowing you to add a block:
   
2. Click the MORE button to choose a custom HTML code block:
   
3. Paste the HTML or JAVASCRIPT code obtained in step 6 above and click the button to Continue:
   
4. The form is displayed as a preview on your editing page and will be visible to your visitors: