Open session



Opens a new API session.

In order to connect the API, you will need to send a request to the API endpoint and create an authorization header with your credentials. More information in the Get Started section


  • Authorization string

    The Autorization header must start with “Basic” followed by the account’s id and the account’s secret glued together with a colon-space and encoded with base 64.
    Example:”Autorization: Basic TkVUSU06bXlzZWNyZXQ=” (where NETIM:mysecret is used to be base 64 encoded as TkVUSU06bXlzZWNyZXQ=) 

  • Content-type string

    Content type of the request

    Only “application/json” is accepted

  • Accept-Language string

    The Accept-Language header is used for the languages of messages.

    Values : “FR”, “EN”

The session ID must be kept for next function calls.

Common language examples

    $encodedAuth = base64_encode("$ID:$secret");
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, '');
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_HTTPHEADER, ["Accept-Language: EN","Authorization: Basic " . $encodedAuth, "Content-Type: application/json"]);
    curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_ANY);
    $result = json_decode(curl_exec ($ch), true);
    $status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close ($ch);
    $sessionID = $result['access_token'];
import java.util.Base64;
public class Example {
	public static void main(String args[]) throws Exception {
		String ID = "ID";
		String secret = "secret";
		String auth = ID + ":" + secret;
		byte[] encodedAuth = Base64.getEncoder().encode(auth.getBytes(StandardCharsets.UTF_8));
		HttpClient client = HttpClient.newHttpClient();
		HttpRequest request = HttpRequest.newBuilder()
			.method("POST", HttpRequest.BodyPublishers.ofString(""))
			.header("Content-Type", "application/json")
			.header("Accept-Language", "EN")
			.header("Authorization", "Basic " + new String(encodedAuth))
		HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
		String result = response.body().toString();
import json
import requests
url = ''
ID = "ID"
secret = "secret"
headers = {"Accept-Language" : "EN", "Content-Type": "application/json"}
response =, auth=(ID, secret), headers=headers)
res = json.loads(response.text)
sessionId = res["access_token"]
curl -X POST \
-H 'Authorization: Basic TkVUSU06bXlzZWNyZXQ=' \
-H 'Content-type: application/json' \
-H 'Accept-Language: EN'