This guide presents the possibilities offered by the API Infomaniak.

Preamble

• The Infomaniak API allows you to harness 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 API Infomaniak are completely free.

Infomaniak API usage protocol

With 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. Here are a few examples of use:

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

For example, for a Service Mail: managing mailboxes, managing aliases, managing automatic responses, managing folders, etc.

Create your first requests with the Infomaniak API

Familiarize yourself with 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 launch a request, it is necessary to use the following syntax: /{version}/{command_path}. It is possible not to specify the version, but in this case, the last version will be applied.

Familiarize yourself with 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.

Get acquainted with 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 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 listed in the documentation, you can 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