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

Obtain a token

To obtain a Newsletter API key:

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 API Key in the left sidebar menu.
4. Click the blue button Generate a key:
   
5. Click the blue button Create a token:
   
6. Choose the appropriate product from the dropdown menu.
7. Choose a validity period.
8. Click the blue button Create a token:
   
9. Enter the password to log in to the Manager as requested.
10. Copy the token to a safe place - it will no longer be accessible after that.

Refer to the Newsletter API documentation.

Este guia explica como ser notificado por e-mail quando um novo assinante se inscreve na sua Newsletter através de um dos seus formulários de contacto.

Ser notificado quando um novo contacto se inscreve

Para aceder à sua Newsletter:

1. Clique aqui para aceder à gestão da sua Newsletter no Manager Infomaniak (precisa de ajuda?).
2. Clique, se necessário, no nome do domínio correspondente na tabela que aparece:
   
3. A interface da Newsletter é exibida.

Em seguida, para aceder ao formulário de inscrição na Newsletter:

1. Clique em Formulários no menu lateral esquerdo.
2. Crie ou edite o formulário cujas inscrições pretende acompanhar:
   
3. Na parte inferior da página, marque a caixa Receber um e-mail quando houver uma nova inscrição.
4. Clique no botão azul Guardar para validar as alterações:
   

Receberá agora um e-mail assim que um contacto se inscrever na sua Newsletter através deste formulário de inscrição.

Basta desmarcar a caixa a qualquer momento para deixar de receber notificações por e-mail.

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: