External API Description

HTTP REST API

You can communicate with zoolo’s REST API using any HTTP REST client. The following section describes what HTTP method, body and query parameters belong to which service method call.

The Server URL is

https://server.zoolo.io

Authentication

Authenticating HTTP (REST) requests is a two step process. First you have to obtain a JWT from the authentication service by POSTing the strategy you want to use:

// POST /authentication the Content-Type header set to application/json
{
  "strategy": "local",
  "email": "your email",
  "password": "your password",
	"otp", "123456" // optional only if two factor is enabled or client changed.
}

Here is what that looks like with curl:

curl -H "Content-Type: application/json" -X POST -d '{"strategy":"local","email":"your email","password":"your password"}' <https://server.zoolo.io/authentication>

Then to authenticate subsequent requests, add the returned accessToken to the Authorization header as Bearer <your access token>:

curl -H "Content-Type: application/json" -H "Authorization: Bearer <your access token>" <https://server.zoolo.io/api/v1/myteamdomain/messages>

⚠️Disclaimer:

You will have to authenticate new clients via an email two factor authentication code once.

add this code to the authentication body one recieved by email and login again.