This guide explains how to add a new Organization to which you will have access with your current Infomaniak account and in which you can add and/or transfer products, link users, etc.

Preamble

• If you are my kSuite users, refer to this other guide.

Create a new Organization

You can add multiple Organizations (i.e., a space to manage your products) by accessing them with the same login credentials to separate your activities professional and personal for example, or when managing multiple clients:

1. Click here to access the management of your settings (Infomaniak Manager).
2. Click on Manage from the My organizations box:
   
3. Click on the Create a new organization button
   
4. Follow the procedure to create a new Organization.

This guide explains how to delete an Infomaniak account (i.e., user account), which means deleting your access to the Manager and/or the Infomaniak Web Mail app ksuite.infomaniak.com/mail.

Preamble

• This operation will immediately delete your calendars and address books.
• All access to the Manager with this identifier will be lost.
• This operation does not delete the email addresses accessed from the account in question (except for some free offers, but in this case, this is specified to you before the deletion operation).
• If the account you are using is the only existing account within an Organization, you must first delete the Organization or appoint someone else to be able to delete your account.

Delete an Infomaniak / Mail account

To access the user profile section:

1. Click here to access the My profile menu on the Infomaniak Manager.
2. Click on the trash can to the right of your name to delete the account and data:
   
3. Enter the login password one last time, then the Infomaniak account will be deleted.

This guide explains how to obtain information on…

• … the connections made to the Manager Infomaniak with your Infomaniak account login,
• … the activities performed within the Manager by your Infomaniak account.

Obtain the log of connections to the Infomaniak account

To view a connection log (active sessions) made to the Manager Infomaniak with your Infomaniak account login:

1. Click here to access the summary of access to the Infomaniak Manager by your Infomaniak account.
2. From the Account Access tab, view the list of devices connected to your Infomaniak account.
3. You can end an open session by clicking on the icon to the far right of the name of the device connected to your account, which will log it out.:
   

Be notified in case of successful or unsuccessful login

To be notified by email upon login or attempted login to your Infomaniak account:

1. Click here to access the security summary of your account on the Infomaniak Manager.
2. Click on Security Settings:
   
3. Select the cases for which you want to be alerted by email (warning upon successful login, or only in case of failed login).
4. Click to Save your changes:
   

In the same place, you can choose from how many unsuccessful attempts minimum to lock your Infomaniak account:

Once locked, the account can be unlocked by an Organization administrator or by a secure form.

Obtain the activity log of the user account

To view recent activities performed within the Manager by your Infomaniak account:

1. Click here to access the activity summary of your account on the Infomaniak Manager.
2. From the Account Activities tab, view the latest activities and actions of your Infomaniak account.
3. Search and log filtering options are available: date, product or type of action:
   

This guide details the procedure to modify the WHOIS details of the domain name holder, which you can apply to an entire batch of domains in your Organization with Infomaniak.

Change details in bulk

To modify the WHOIS details of multiple domain names at once:

1. Click here to access the management of your domain on the Infomaniak Manager (need help?).
2. Select the domains whose owner needs to be modified using the checkboxes.
3. Click on Change owner at the bottom of the table:
4. Choose an existing contact card…
5. … or click on the Add button to create an entirely new contact card.
6. Check your selection as well as any potential modification fees in the box:
   
7. Click on Confirm.

If the order of an Infomaniak service is interrupted and cancelled before its end, while a bank transfer is in progress, the money will be deposited into your prepaid account.

Infomaniak kAuth is a free mobile app that enhances and simplifies the security of Infomaniak accounts protected by two-factor authentication (2FA). It is one of the methods that allows you to secure access to your Infomaniak user account.

Preamble

• Two-step verification protects your account and personal data when logging in to Infomaniak tools (manager.infomaniak.com and ksuite.infomaniak.com) by requesting:
  • your password…
  • then a second security method:
    
  • The mobile app kAuth is among these methods (learn more about 2FA):
    

Install the kAuth app

Prerequisites

• Have an Infomaniak account (know your username and password).
• Have an iOS or Android mobile device.
• From your iOS or Android mobile device, download the Infomaniak kAuth app here:
  
  
   
• Install and open the application.

Then, you have two options to link your Infomaniak accounts to kAuth:

1. Log in from this mobile (recommended):
   1. Open the kAuth app from your mobile device.
   2. Click on Log in from this mobile.
   3. Enter the credentials of the Infomaniak account to be linked and authenticate your connection if necessary (need help?).
   4. Click the Authorize button.
2. Log in from a computer (if you choose this method, you will need a computer connected to the Internet):
   1. Open the kAuth app from a mobile device.
   2. Click on Log in from a computer.
   3. On your computer, open the page manager.infomaniak.com/2fa
      1. if double authentication is not yet activated: click on Activate and choose kAuth Application.
      2. if double authentication is already activated: click on Add an option then choose kAuth Application.
   4. On your mobile, click on Continue.
   5. If necessary, allow kAuth to access your camera (only required to scan the identification QR code).
   6. On your computer, click Next to display the QR code to be scanned.
   7. Scan the QR code displayed on the computer.

Save backup codes

If you have just activated double authentication, the app will automatically display your 10 personal backup codes.

How the mobile app works

When you attempt to log in to your account and after successfully entering your usual password, you receive a push notification on your mobile device asking you to authorize the connection ("YES / NO"), via a notification from the kAuth app:

or directly in the kAuth app:

If the connection is authorized, the initial page is automatically redirected to the Infomaniak account. You do not need to manually enter a one-time code as with an OTP app traditional or a code sent by SMS.

And without an Internet connection?

Push notifications do not work without an Internet connection, but kAuth also works without an Internet connection and always allows you to display a one-time code in the same way as a traditional application: OTP app Traditional:

1. Open kAuth from your mobile device.
2. Click on the relevant Infomaniak account.
3. Copy the one-time code (each code is valid for 30 seconds) on the login page:
   

You can thus always access your account while traveling or on vacation.

Add additional accounts

kAuth allows you to manage multiple Infomaniak accounts:

1. Open kAuth from your mobile device.
2. Click on the blue button 
   
3. Repeat the steps described above to link the account.

Remove an account from kAuth

To remove your Infomaniak identity from the kAuth app, you must deactivate the kAuth security method from the 2FA section of the Infomaniak account manager concerned.

This guide explains how to change the password of your Infomaniak account (= user account) on the Manager, the administration interface of your Infomaniak products.

Preamble

• This password also allows you to log in to my kSuite and various iOS/Android applications such as kDrive, Infomaniak Mail, etc. (learn more) but it is not your email address password!
• If you cannot log in, you will not be able to change the password; refer to this other guide in this case.

Change the Infomaniak account password

To change the password of your Infomaniak account:

1. Click here to access the management of your settings (Infomaniak Manager).
2. Click on Modify from the Connection settings box under connection password:
   
3. Click on Modify:
   
4. Enter the current connection password as well as the desired new password.
5. Click on Save.

This guide explains how to remove an Infomaniak account configured in the Infomaniak mobile app kAuth (app for iOS/Android smartphone or tablet).

Remove an account from the kAuth mobile app

To delete one of the accounts, you must use a web browser, preferably on a computer:

1. Click here to access the management of two-factor authentication on the Infomaniak Manager.
2. Click on the trash can of the box corresponding to the Infomaniak kAuth application:
   
3. Enter the password to log in to the Infomaniak account.
4. A kAuth notification is sent to the mobile device on which the app is installed:
   
5. The message is also displayed to the user within the kAuth app directly:
   

This guide explains how to regain access to Infomaniak tools (manager.infomaniak.com and Mail / ksuite.infomaniak.com) in case you forget your password or Infomaniak account login ID.

Preamble

• To log in within an Organization that manages one or more Infomaniak products, go to manager.infomaniak.com and enter the following information:
  1. A login email address (ID for the Infomaniak account).
  2. The password chosen during your registration.
  3. A additional code if 2FA (two-factor authentication) is enabled.
• If the platform login works and you are missing a password for one of your email addresses, refer to this other guide.
• If you are experiencing a login form display issue, particularly with a mobile device, refer to this other guide on the subject.

You have forgotten...

... the Infomaniak account password

If you have forgotten this password, follow the reset procedure:

1. Click here to reset your password.
2. Enter the login email address of your Infomaniak account
3. Choose the desired recovery option or follow the identity verification procedure by clicking on “You do not have access to any option”.

... the login email address for the Infomaniak account

During your registration, you had to provide a phone number; it is possible to retrieve the login email address for the Infomaniak account using your phone number:

1. Click here to retrieve your login email address for the Infomaniak account.
2. Enter your mobile number.
3. Enter (if necessary) your recovery email address.

Two scenarios are then possible:

1. The system manages to identify your account: choose how to receive your Infomaniak account login ID.
2. In the opposite case: follow the on-screen assistant to manually verify your identity or via kCheck:
   

And if the email address no longer exists...

If you have an Infomaniak account for which the login ID is of the form toto123@yahoo.com, there is no problem if the email address toto123@yahoo.com is deleted or is no longer valid. You just need to log in one last time to the Infomaniak Manager with this ID toto123@yahoo.com and take note of this other guide to modify your Infomaniak account login email address.

On the other hand, if the email address used as an ID is hosted by Infomaniak (for example anna789@assoziation.ch) and an administrator deletes the email address in question or cancels the “assoziation.ch” Mail Service, the situation is different: you automatically receive an email on the secondary address and an SMS on the mobile phone number specified in your Infomaniak account:

The situation can also occur in a specific case of mail service management.

To be able to access your Infomaniak account again now that access is no longer possible with the old email address, the Infomaniak account user must go to the address mentioned in the SMS:

1. Click here to access the login page.
2. Enter the username specified in the SMS (usually the initials of your account and a sequence of numbers).
3. Enter the usual password (it has not changed):
   
4. Enter the new requested information:
   
5. You will be logged in to your account again:
   

This guide concerns the mobile app kCheck (application for iOS/Android smartphone or tablet), created to simplify identity verification procedures and strengthen the security of your Infomaniak account.

Preamble

• For security reasons, to guarantee the identity of the person making a specific request to Infomaniak, an identity verification procedure may be triggered in the following cases (non-exhaustive list):
  • forgetting an Infomaniak account password (user account)
  • forgetting a login email address
  • deactivation of double authentication (2FA)
  • unlocking an Infomaniak account
  • during the first transfer of revenue for the product Ticketing
  • when ordering a product (suspicion of spam or fraud, brand name, etc.)
• This application allows you to securely transfer the requested items.
• Infomaniak respects your privacy: the information transmitted via the kCheck application will be kept until the complete processing of your file; it will in all cases be automatically deleted after 72 hours in case of non-processing of this request.

Start identity verification

Prerequisites

• A QR code or a link provided by Infomaniak.
• The mobile app kCheck installed on your device iOS (iPhone, etc.) or Android.
• An Internet connection on the mobile device.

You can then have your identity verified with kCheck:

1. Launch the kCheck app on your mobile.
2. Press Start.
3. Press Scan a QR code.
4. Point the QR code provided using the camera.
5. Enter your mobile phone number.
6. Enter the confirmation code received.
7. Authorize geolocation (mandatory to continue the procedure).
8. Select the type of ID you have (ID card or passport).
9. Follow the steps to photograph your ID.
10. Take a selfie (of yourself) with your ID in your hand in front of you.

Your documents will then be securely transmitted to Infomaniak support. These requests are processed on a priority basis with an average response time of 2 hours during opening hours.

If your order is blocked...

For security reasons, some orders may be automatically blocked.

At the time of your order, an e-mail is sent to the email address connected to your Infomaniak Manager account. This email contains the procedure to unblock your order. If you do not find it, you can resend it from your Manager by clicking on Resend procedure from the red banner‍ informing you of the blockage.

Prerequisites

• Open the email containing the unblocking procedure.
• The mobile app kCheck installed on your device iOS (iPhone, etc.) or Android.
• An Internet connection on the mobile device.

You can then start the unblocking procedure with kCheck:

1. Launch the kCheck app on your mobile.
2. Press Start.
3. Press Scan a QR code.
4. Scan the QR code present in the email.
5. Follow the unblocking procedure to the end.

Special cases

• If there is no response from you within a 10-day period, the order is automatically canceled and the payment is fully refunded to the payment method used.
• In case you do not have a mobile device to follow this procedure, contact Infomaniak support.

This guide covers the activation of cookies and JavaScript on the main web browsers.

Preamble

• Activating cookies allows websites to identify you and remember your preferences, such as your preferred language or items you have added to your cart.
• Activating JavaScript allows websites to be more interactive and dynamic, and offers features such as video playback or game creation.
• Some websites (including mobile apps) may not function correctly if cookies or JavaScript in the device's native browser are disabled.
• You can also choose to activate cookies and/or JavaScript only for certain websites.

Manage cookies and JavaScript

The exact location of the options to activate cookies and JavaScript may vary slightly from one browser version to another.

Click to see the corresponding guides:

Browser	Enable or disable cookies	Enable or disable JavaScript
Chrome
Firefox
Edge
Safari

Troubleshoot an app connection issue

If you encounter a login window like the one below, for example with the mobile app Infomaniak Mail (app for iOS smartphone or tablet) on iPhone:

1. Open the advanced settings of Safari on your mobile device.
2. Temporarily disable the toggle switch that blocks all cookies:
   
3. It will then be possible to display the full login window and log in; you can always re-block cookies after logging in if you wish.

This guide helps you understand the structure of your Infomaniak services, with the aim of familiarizing you with the terminology used and helping you easily manage your management interfaces, mainly when using my kSuite.

Preamble

• The Organization is the term that represents the grouping of Infomaniak services & users (you and potential collaborators, family members, etc.).
• To understand what an Organization really represents, this guide is structured around several possible situations currently:
  1. Any new registration for a free my ksuite address (ik.me / etik.com / ikmail.com).
  2. Any new registration for other Infomaniak services.
  3. Combined use of my kSuite and other services in the ecosystem:
     1. Sign up for my kSuite by specifying an existing Infomaniak account
     2. Purchase Infomaniak products with only a my kSuite account

1. my kSuite Registration (ik.me / etik.com / ikmail.com)

When registering on welcome.infomaniak.com/signup/myksuite, you chose the name of your email address, for example anna.a@ik.me and then entered a personal phone number:

1. Once the registration is validated, you access your email address anna.a@ik.me on the Web app Mail ksuite.infomaniak.com/mail:
   
2. You can distinguish:
   
   1. The logo/type of your Organization, which in this case indicates that it is a my kSuite account.
   2. The button ‍ allows you to access the Manager manager.infomaniak.com and other apps / other services related to my kSuite:
      
      • The Manager in this case will contain nothing more than information about managing your my kSuite account:
        
   3. The initials are those of your Infomaniak account (first name / last name entered during registration):
      

This account my kSuite will not be able to directly contain hosting products, or kSuite with a domain name, etc. The rest of this guide explains how to create a more comprehensive Organization if necessary.

Note that it is not possible to export your services my kSuite to another Organization.

To use your new my kSuite email address on the Web app Mail, refer to this other guide.

2. Registration and purchase of hosting, domain, etc.

When registering on welcome.infomaniak.com/signup/, you chose your login identifier, in the form of a personal email address, for example anna.alpha@orange.fr :

You then chose the type of Organization you wanted to create (personal, or for a company, association, etc.):

1. Once registration is complete, you will access the Manager manager.infomaniak.com and your Organization is still an “empty shell” of which you are currently the sole legal representative:
   
2. You can distinguish:
   
   1. The logo/type of your Organization, which in this case indicates that it is a personal Organization (automatically named upon creation via the first name/last name of the creator); this can be customized.
   2. The button ‍ allows you to access kSuite ksuite.infomaniak.com and other apps / other services related to the free kSuite added to your new Organization:
      
   3. The initials are those of your Infomaniak account (first name / last name provided during registration):
      

3. Combined use

What happens if you sign up for my kSuite by specifying an existing Infomaniak account that you already own for using hosting products?

Or how to proceed if you wish to acquire hosting products when you only have a my kSuite ?

Sign up for my kSuite by specifying an existing account

When signing up on welcome.infomaniak.com/signup/myksuite, you choose to log in with an existing account…

1. Obviously, you should not specify a my kSuite account (anna.a@ik.me for example) as an existing account, as you cannot have multiple ik.me / etik.com / ikmail.com email addresses:
   
2. Specify your existing Organization account, anna.alpha@orange.fr:
   
3. Thus, the creation of a my kSuite account is proposed to you:
   
4. Once registration is complete, you will access the Manager manager.infomaniak.com:
   1. your previous Organization is visible…
   2. separated from my kSuite currently selected:
      
5. Click on one or the other of the Organizations/my kSuite from this menu (always accessible permanently at the top left) to switch from one to the other.

Acquiring products with only one account my kSuite

Another situation: you wish to acquire on www.infomaniak.com one of the services offered by Infomaniak, for example a domain name for your future site / email:

1. You will be redirected to the Infomaniak Shop; proceed to the next step:
   
2. At the step where you need to specify your existing Infomaniak identifier, if any, you enter your existing my kSuite account (anna.alpha@ikmail.com in this example):
   
3. Your existing identifier is recognized, you must authenticate:
   
4. Then you will necessarily go through the Organization creation step; choose the type of Organization you wish to create (personal, or for a company, association, etc.):
   
5. To finalize the purchase, the details related to the Organization will be requested for billing (they are also used to generate a registrant for the ordered domain name); all you have to do is complete the order:
   
6. Once the order is completed, you access the Manager manager.infomaniak.com:
   
   1. your new Organization is visible…
   2. separated from my kSuite currently selected.
7. Click on the new Organization to switch to it and manage your ordered products:
   
8. To switch from one to the other of the Organizations/my kSuite click on this menu (always accessible permanently at the top left):
   1. A first time to arrive on the main page of the Manager,
   2. then on the chevron ‍ allowing the choice of the destination:
      
9. You will find your email address my kSuite.

Thank you for choosing Infomaniak for hosting your IT solutions and congratulations on optimizing your customer experience. You are taking it to the next level with the Premium Support offer.

Preamble

• Since the beginning of Infomaniak, the Support department has been working to resolve customer issues.
  • Free and unlimited, it responds to all your requests in the shortest possible time, this 5/7 from 9 am to 6 pm by phone and 7/7 by email from 6 am to 11 pm.
  • Infomaniak does not intervene directly on your machines or networks but may request access to Mail or kDrive on a case-by-case basis.
  • Many technical guides answer common questions, and specialized partners offer personalized support beyond the role of the host.
• The Premium Support commitment is for a minimum of 6 months, with no possibility of canceling before the end of the term.

Infomaniak Premium Support

By choosing one of the 3 support options, you benefit from personalized advice, product optimization, and faster response times and extended hours compared to standard support. Here are the details of these 3 versions:

Support Plus

• The partners can benefit from this support.
• A first response is guaranteed within 4 hours (opening hours above).

Support Pro

• A response is guaranteed within 2 hours (opening hours above).
• Emergency calls can be made 24/7.
• You benefit from a designated account manager, 5/7 from 9 am to 6 pm.

Support Enterprise

• A response is guaranteed within 1 hour (opening hours above).
• Emergency calls can be made 24/7.
• Customized advice is provided 5/7 from 9 am to 6 pm.
• You benefit from two designated account managers (including one technical).

Frequently Asked Questions

• What is the VIP code and where to get it?
• What is the technical PDF document?
• Commitment period
• Premium Support limits
• Is it advantageous to pay annually?
• What does guaranteed response time mean?

The entire Infomaniak team is eager to provide you with superior service and help you get the most out of its offers.

This guide concerns the WordPress module "Infomaniak Connect for OpenID" which allows users to log in to your WordPress site (whether it is hosted by Infomaniak or not) using their Infomaniak credentials.

Preamble

• Allowing login via an Infomaniak account on your WordPress site allows your visitors to comment, register for courses, or access any member-only content with a single click, without having to create a new account.
• It saves them time and is a safer method for you, as you do not have to manage additional passwords.
• The operation of this external module is identical to the optionsLog in with Google", "Log in with Facebook" or "Log in with Apple"; it uses the standard protocols OAuth2 and OpenID Connect to enable single sign-on (SSO).

A. Create an application with Auth Infomaniak

To do this:

1. Click here to access the management of your product Auth on the Infomaniak Manager (need help?).
2. Click the button to Create a new application:
   
3. Choose the type "Web Front-End".
4. Give a name to your application.
5. In the URL field, specify the domain name corresponding to your WordPress site followed by /openid-connect-authorize (refer to the GitHub documentation if necessary).
6. Click the button to complete the app creation:
   
7. Carefully note the 2 pieces of information obtained upon completion of your OAuth2 application:
   

B. Configure the WordPress extension

To do this:

1. Search for the extension Infomaniak Connect for OpenID on the WordPress extensions platform from your site.
2. Install and activate the extension:
   
3. Configure the extension from the Settings menu:
   
4. The only fields to fill in are Client ID and Client Secret Key and come from the information obtained in point A above:
   
5. Do not forget to save the changes made to the extension settings.
6. An additional button for logging in with an Infomaniak identifier is now visible on your user login page /wp-admin (/wp-login.php):
   

This guide concerns the Typo3 module "t3ext-infomaniak-auth" which allows users to log in to your Typo3 site (whether hosted by Infomaniak or not) using their Infomaniak credentials.

Preamble

• Allowing login via an Infomaniak account on your Typo3 site enables your visitors to comment, register for courses, or access any member-only content with a single click, without having to create a new account.
• This saves them time and is a safer method for you, as you do not have to manage additional passwords.
• The operation of this external module is identical to the options "Sign in with Google", "Sign in with Facebook" or "Sign in with Apple"; it uses the standard protocols OAuth2 and OpenID Connect to enable single sign-on (SSO).

A. Create an application with Auth Infomaniak

To do this:

1. Click here to access the management of your product Auth on the Infomaniak Manager (need help?).
2. Click the button to Create a new application: 
   
3. Choose the type "Web Front-End".
4. Give a name to your application.
5. In the URL field, enter the domain name corresponding to your Typo3 site followed by /openid-connect-authorize (refer to the GitHub documentation if necessary).
6. Click the button to complete the app creation:
   
7. Carefully note the 2 pieces of information obtained during the finalization of your OAuth2 application:
   

B. Configure the Typo3 extension

In SSH, deploy Composer if necessary to retrieve the t3ext-infomaniak-auth extensions. To do this:

• The SSH command for installing the extension is here:
  • https://packagist.org/packages/infomaniak/t3ext-infomaniak-auth 

Then, in Typo3:

1. Log in to your Typo3 administration interface.
   • Check if necessary that the Infomaniak extension is activated:
     
2. Click on Settings in the left sidebar menu.
3. Click on Configure extensions:
   
4. Click on the chevron ‍ to the right of typo3-openid-main to expand the client tab.
5. The only fields to fill in are clientID and clientSecret and come from the information obtained in point A above.
6. Do not forget to save the changes made to the extension settings:
   
7. An additional button for logging in with an Infomaniak identifier is now visible on your user login page:
   

This guide concerns the Drupal module "Infomaniak_Connect" which allows users to log in to your Drupal site (whether hosted by Infomaniak or not) using their Infomaniak credentials.

Preamble

• Allowing login via an Infomaniak account on your Drupal site enables your visitors to comment, register for courses, or access any member-restricted content with a single click, without having to create a new account.
• This saves them time and is a safer method for you, as you do not have to manage additional passwords.
• The operation of this external module is identical to the options "Log in with Google", "Log in with Facebook" or "Log in with Apple"; it uses the standard protocols OAuth2 and OpenID Connect to enable single sign-on (SSO).

A. Create an application with Auth Infomaniak

To do this:

1. Click here to access the management of your product Auth on the Infomaniak Manager (need help?).
2. Click the button to Create a new application:
   
3. Choose the type "Web Front-End".
4. Give a name to your application.
5. In the URL field, specify the domain name corresponding to your Drupal site followed by /openid-connect-authorize (refer to the GitHub documentation if necessary).
6. Click the button to complete the app creation:
   
7. Carefully note the 2 pieces of information obtained during the finalization of your OAuth2 application:
   

B. Configure the Drupal extension

Via SSH, deploy Composer if necessary to retrieve the openid_connect and infomaniak_connect extensions. To do this:

• You may need to edit the composer.json file as the version of openid_connect is not yet considered stable. Add:

• "minimum-stability": "dev",
  "prefer-stable": true

• The SSH commands for installing the 2 extensions are here:
  • https://www.drupal.org/project/openid_connect
  • https://www.drupal.org/project/infomaniak_connect

Then, on Drupal:

1. Search for the Infomaniak module among your pre-installed modules.
2. Select it.
3. Click the Install button:
   
4. The installation of dependencies will proceed:
   
5. Under Configuration, click to set up the OpenID connection:
   
6. Click the edit button:
   
7. The only fields to fill in are Client ID and Client Secret and come from the information obtained in point A above:
    
8. Do not forget to save the changes made to the extension settings.
9. In the Settings tab, you can choose the display type for your login page; do not forget to save:
   
10. An additional button for logging in with an Infomaniak identifier is now visible on your login page for users:
     

This guide details the management of the Organization Directory, i.e., a “special” address book present in the Infomaniak Web app Contacts (online service ksuite.infomaniak.com/contacts).

Preamble

• The Organization Directory is "automatically created" by the various users who make up one of the Organizations to which your user is attached.
• If work teams are created within the Organization, then these form groups visible in the Organization Directory:
  
• This address book is automatically synchronized with all internal users of your Organization.
• An administrator of the Organization can make certain entries in the directory private to hide them from users with fewer permissions:
  
• It is not possible to export it or rename it.
  • You can change its display color:
    

Access the directory

If your login matches and belongs to one (or more) Organizations, it is possible to access the various directories of these Organizations:

1. Click here  to access the Infomaniak Web app Contacts (online service ksuite.infomaniak.com/contacts).
2. Click on the chevron ‍ to the left of the name of the Organization concerned.
3. Click on Directory of {Organization name}…
4. The contacts of the selected Organization are displayed on the right:
   

Modify the details of a directory contact

You can do many things (copy, export the card, view email exchanges or calendar events, add to favorites, call, etc.) by clicking on the card of a contact in the Organization Directory address book but you will not be able to modify the details on behalf of the person concerned:

To modify the main information, the person concerned (the one for whom a change must be made) must log in to their profile and modify it (see below):

A. First & last name

To modify the first name and last name visible in the directory, the user concerned (here faq@exemple-domaine.ch) must log in to their account and modify their details. Refer to this other guide on this subject.

B. Email address

To modify the email address visible in the directory, the user concerned must log in to their account and modify their details. Refer to this other guide on this subject.

C. Phone number

To modify the phone number visible in the directory, the user concerned must log in to their account and modify their contact details. Refer to this other guide on this subject.

This guide concerns OAuth2 applications to connect to your external services via your Infomaniak login ID.

Manage Infomaniak OAuth2 apps

To do this:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click the blue button Create a new application:
   
3. Choose the type suitable for your current need and project.
4. Give a name to the application.
5. Enter the URL of the application according to the technical information available to you.
6. Click on the button to create the application:
   
7. Copy the information (Client ID, Client secret) to a safe place - they will no longer be accessible after that:
   

This guide is intended for developers and advanced users and presents the possibilities offered by the Infomaniak API.

Preamble

• The Infomaniak API allows you to leverage the full potential of the Infomaniak ecosystem in your applications and using the language of your choice.
• The Infomaniak API is a REST API; the protocol used is HTTP, requests and responses are encoded in JSON format; authentication is performed via the OAuth 2 protocol.
• Access to and use of the Infomaniak API are completely free.

Infomaniak API Usage Protocol

Using the API, you will be able to automate a wide range of actions and tasks on Infomaniak products and services, without having to use the product interfaces. A few examples of use:

• Store data.
• Send direct mail campaigns.
• Broadcast video or radio streams.
• Order or manage products.
• ... and much more!

For example, for a Mail Service: managing mailboxes, managing aliases, managing automatic responses, managing folders, etc. For kChat, post a message on a channel…

Create your first requests with the Infomaniak API

Refer to the documentation in English only on the possibilities offered by the API.

Request format

The Infomaniak API is a REST API. The protocol used is HTTP, requests and responses are encoded in JSON. Authentication is performed via the OAuth 2 protocol.

To initiate a request, you must use the following syntax: /{version}/{command_path}. It is possible not to specify the version, but in this case, the latest version will be applied. Refer to the full list of available requests with the Infomaniak API.

API Response Codes

When using the Infomaniak API, you may encounter various response codes. These codes precisely indicate the status of your request. Refer to the complete list.

Limits & Restrictions

There is a limit of 60 requests per minute with the Infomaniak API. This limit cannot be increased. The use of the API is restricted to the products listed in the official documentation. Regular additions of products and services are made to it. If the product or service you are interested in is in the documentation, you will be able to use the following requests: GET ; POST ; PATCH ; PUT ; DELETE.

Learn more

• Generate and manage API tokens
• Infomaniak API: Documentation
• API Newsletter
• Make your first request using Curl
• Make your first request using PostMan

Complete list of tutorials

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: