This guide explains how to use the Infomaniak Newsletter tool with an external domain name (not managed at Infomaniak).

Prerequisites

• The domain name must belong to you.
• Synonym domains and their main domain cannot be used to send newsletters.
  • It is possible to configure your synonyms as aliases.

Link an external domain

To access the management of Newsletter sending domains:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. If you already have a Newsletter, click on Add a domain:
   
   • Otherwise, click on Start for free:
     
3. Select Other domain from the dropdown menu before entering (or enter directly) the domain name with which you want to send newsletters.
4. Choose a possible monthly limit.
5. Click the button to Continue:
   
6. Add the TXT / CNAME / DKIM records that you will receive by email and visible on the interface by clicking on the button:
   

This guide explains how to be notified by email 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 management of your product on the Infomaniak Manager (need help?).
2. Click if necessary 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 sidebar menu.
2. Create or edit the form you want to track subscriptions:
   
3. At the bottom of the page, check the box Receive an email upon new subscription.
4. Click 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.

You can uncheck the box at any time to no longer be notified by email.

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 concerns the management of forms that allow registration for the Newsletter that you manage on Infomaniak.

Prerequisites

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

Copy the code necessary for integrating the form

To access the forms of your Newsletter and obtain the integration code:

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

Insert the form on a website…

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

… with WordPress

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

… with Infomaniak Site Creator

1. Hover over the desired location on the page to display a PLUS button to add a block:
   
2. Click on the PLUS 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 previewed on your editing page and displayed for your visitors: