Developer Hub

Welcome to the Synerise developer hub. Add extraordinary value to Your business with a Synerise integration, webhooks, API or customize Synerise for Your organization.

Get Started
Suggest Edits

authorization

 

The Synerise Platform uses JWT as an authorization method in order to simplify the API consumption process. The idea is very simple: you send your credentials to the login endpoint and it returns you a token. Then you have to pass it as an Authorization header to any subsequent request, just like here: Authorization: Bearer: [token]. It is valid for 1 hour only, but it does not mean, that you cannot use our API any longer - if you want to prolongate the session, you just request the refresh endpoint and a new token is given to you.

To verify your token signature, use the public key available here.

Synerise distinguishes three different types of API consumers:

  • Client is the end user of your site. The one who browses your pages, makes purchases and uses mobile applications. That person is able to register an account, update it's data and e.g. redeem a coupon, so some endpoints require a login process here, especially when using the mobile application. A client is only able to modify his own data.

  • User is the end user of Synerise. The one who logs in to https://app.synerise.com/ It might be you, or some of your coworkers. Because a large part of user activitites could be automated using our API, a separate login mechanism is required here.

  • Profile We call a Business Profile our relationship with a particular company or organisation. Some of the operations which could be done with Synerise don't fit very well to the previous categories, like e.g. sending batches of client information or transactions. In general you use the Profile authorization if the operation you're about to execute doesn't have a particular physical person (a User or Client) bound to it.

In order to log-in you have to use an API key. These keys could be created, managed and revoked on demand using the Synerise Application. They could not be used for different login methods, and could have even stricter limitations for specific purposes. More information about those keys could be found in our Knowledge Base.

Suggest Edits

Choose user profile

Retrieves a JWT which is bound to a specific business profile. In order to perform
most of the operations in user context it is required not only to be authenticated
as a user, but also to have a business profile selected.

In order to use this endpoint, you have to be logged in as user.

 
posthttps://api.synerise.com/v4/auth/login/user/profile/id

Path Params

id
uuid
required

Business profile UUID

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.1.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/auth/login/user/profile/id \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/auth/login/user/profile/id',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/auth/login/user/profile/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/auth/login/user/profile/id");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/auth/login/user/profile/id"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Client login

Log in a client in order to obtain the JWT token, which could be used in subsequent requests.
The token is valid for 1 hour. If you want to use our API longer, you have to request a new one
by requesting the Client token refresh endpoint before this time runs out.

 
posthttps://api.synerise.com/v4/auth/login/client

Body Params

apiKey
uuid
required

Client API key

email
email
required

Email address

password
password
required

Password

deviceId
string

Device Id

Headers

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/auth/login/client \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/auth/login/client',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/auth/login/client")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/auth/login/client");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/auth/login/client"

headers = {
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Profile login

Log in a profile in order to obtain the JWT token, which could be used in subsequent requests.
The token is valid for 1 hour. If you want to use our API longer, you have to request a new one
by requesting the Profile token refresh endpoint before this time runs out.

 
posthttps://api.synerise.com/v4/auth/login/profile

Body Params

apiKey
uuid
required

Business profile API key

Headers

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/auth/login/profile \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/auth/login/profile',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/auth/login/profile")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/auth/login/profile");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/auth/login/profile"

headers = {
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

User login

Log in a user in order to obtain the JWT token, which could be used in subsequent requests.
The token is valid for 1 hour. If you want to use our API longer, you have to request a new one
by requesting the User token refresh endpoint before this time runs out.

 
posthttps://api.synerise.com/v4/auth/login/user

Body Params

username
email
required

Username

password
password
required

Password

Headers

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/auth/login/user \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/auth/login/user',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/auth/login/user")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/auth/login/user");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/auth/login/user"

headers = {
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Client token refresh

Retrieves a refreshed JWT token in order to prolongate the client session.

In order to use this endpoint, you have to be logged in as client.

 
gethttps://api.synerise.com/v4/auth/refresh/client

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request GET \
  --url https://api.synerise.com/v4/auth/refresh/client \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.synerise.com/v4/auth/refresh/client',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/auth/refresh/client")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.synerise.com/v4/auth/refresh/client");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/auth/refresh/client"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Profile token refresh

Retrieves a refreshed JWT token in order to prolongate the profile session.

In order to use this endpoint, you have to be logged in as business profile.

 
gethttps://api.synerise.com/v4/auth/refresh/profile

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request GET \
  --url https://api.synerise.com/v4/auth/refresh/profile \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.synerise.com/v4/auth/refresh/profile',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/auth/refresh/profile")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.synerise.com/v4/auth/refresh/profile");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/auth/refresh/profile"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

User token refresh

Retrieves a refreshed JWT token in order to prolongate the user session.

In order to use this endpoint, you have to be logged in as user.

 
gethttps://api.synerise.com/v4/auth/refresh/user

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request GET \
  --url https://api.synerise.com/v4/auth/refresh/user \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.synerise.com/v4/auth/refresh/user',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/auth/refresh/user")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.synerise.com/v4/auth/refresh/user");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/auth/refresh/user"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results

One of the most important areas of Synerise is Client management. We call a Client a human being, who does some actions on your website or mobile app. Because people tend to use many different devices and not always log in from the same location, some nifty data merging strategy is required. This merging process is one of our core domain areas - we try to connect many different profiles, which could have been created for a single person and we do it by performing sophisticated event analysis.

Because of this fact, the unique identification of the client in Synerise is not that simple, and isn't really a good foundation for a REST API.

We admit, though, that it is often very important to send us client data in a programmatical manner. In order to do so, we expect from you to send at least one of most important client determinants - email address, phone number, your internal identifier of the client, or our numeric identifier. We also accept uuids for information regarding anonymous clients, e.g. those who have used some of your website's features without identifying themselves.

Suggest Edits

Batch add/update

Enqueue a list of batch operations to execute. Every changeset has to be compatible with Update client.
If you don't have a value for a field - don't send it at all, because sending null may remove existing value.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_CLIENT scope assigned
or you have to be logged in as user and have ROLE_CLIENT_EDIT role assigned.

 
posthttps://api.synerise.com/v4/clients/batch

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.1.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/clients/batch \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/clients/batch',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/clients/batch")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/clients/batch");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/clients/batch"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Get client browsers

Get client browsers.

Note that this endpoint is available from version 4.1.0

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_CLIENT scope assigned
or you have to be logged in as user and have ROLE_CLIENT_SHOW role assigned.

 
gethttps://api.synerise.com/v4/clients/id/browsers

Path Params

id
int64
required

Client ID

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request GET \
  --url https://api.synerise.com/v4/clients/id/browsers \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.synerise.com/v4/clients/id/browsers',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/clients/id/browsers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.synerise.com/v4/clients/id/browsers");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/clients/id/browsers"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Find client by custom id

Find a client by custom ID. Because it has to be unique, only one client could be returned. If no client is
found, HTTP 404 is returned.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_CLIENT scope assigned
or you have to be logged in as user and have ROLE_CLIENT_SHOW role assigned.

 
gethttps://api.synerise.com/v4/clients/by-custom-id/id

Path Params

id
string
required

Custom ID

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request GET \
  --url https://api.synerise.com/v4/clients/by-custom-id/id \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.synerise.com/v4/clients/by-custom-id/id',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/clients/by-custom-id/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.synerise.com/v4/clients/by-custom-id/id");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/clients/by-custom-id/id"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Find client by email

Find a client by email address. Because it has to be unique, only one client could be returned. If no client is
found, HTTP 404 is returned.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_CLIENT scope assigned
or you have to be logged in as user and have ROLE_CLIENT_SHOW role assigned.

 
gethttps://api.synerise.com/v4/clients/by-email/email

Path Params

email
email
required

Email address

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request GET \
  --url https://api.synerise.com/v4/clients/by-email/email \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.synerise.com/v4/clients/by-email/email',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/clients/by-email/email")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.synerise.com/v4/clients/by-email/email");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/clients/by-email/email"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Find clients by list

Find clients by a predefined list (created here - Create client list).
You have to pass the list ID and pagination parameters. If no clients are found, HTTP 404 is returned.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_CLIENT scope assigned
or you have to be logged in as user and have ROLE_CLIENT_SHOW role assigned.

 
gethttps://api.synerise.com/v4/clients/by-list/id

Path Params

id
uuid
required

List ID

Query Params

pageIndex
int32
required

Page index (1 - based)

pageSize
int32
required

Page size (max. 250)

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request GET \
  --url 'https://api.synerise.com/v4/clients/by-list/id?pageIndex=pageIndex&pageSize=pageSize' \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.synerise.com/v4/clients/by-list/id',
  qs: 
   { pageIndex: 'pageIndex',
     pageSize: 'pageSize' },
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/clients/by-list/id?pageIndex=pageIndex&pageSize=pageSize")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.synerise.com/v4/clients/by-list/id?pageIndex=pageIndex&pageSize=pageSize");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/clients/by-list/id"

querystring = {"pageIndex":"pageIndex","pageSize":"pageSize"}

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("GET", url, headers=headers, params=querystring)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Find client by phone number

Find a client by phone number. Because it has to be unique, only one client could be returned. If no client is
found, HTTP 404 is returned.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_CLIENT scope assigned
or you have to be logged in as user and have ROLE_CLIENT_SHOW role assigned.

 
gethttps://api.synerise.com/v4/clients/by-phone/phone

Path Params

phone
string
required

Phone number

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request GET \
  --url https://api.synerise.com/v4/clients/by-phone/phone \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.synerise.com/v4/clients/by-phone/phone',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/clients/by-phone/phone")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.synerise.com/v4/clients/by-phone/phone");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/clients/by-phone/phone"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Find client by uuid

Find a client by uuid. Because it has to be unique, only one client could be returned. If no client is
found, HTTP 404 is returned.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_CLIENT scope assigned
or you have to be logged in as user and have ROLE_CLIENT_SHOW role assigned.

 
gethttps://api.synerise.com/v4/clients/by-uuid/uuid

Path Params

uuid
uuid
required

Client's uuid

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request GET \
  --url https://api.synerise.com/v4/clients/by-uuid/uuid \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.synerise.com/v4/clients/by-uuid/uuid',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/clients/by-uuid/uuid")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.synerise.com/v4/clients/by-uuid/uuid");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/clients/by-uuid/uuid"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Link client device by client id

Add client device by his id. Every client is allowed to have many different devices.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_CLIENT scope assigned
or you have to be logged in as user and have ROLE_CLIENT_SHOW role assigned.

 
posthttps://api.synerise.com/v4/clients/id/linked-devices

Path Params

id
string
required

Client's id

Body Params

deviceId
string
required

Unique device ID How to get it on Android and on iOS

registrationId
string
type
string
required
bluetoothAddress
string

Bluetooth interface address (eg. 00:11:22:33:FF:EE)

macAddress
string

WiFi card MAC address (eg. 00:11:22:33:FF:EE)

manufacturer
string

Manufacturer name

model
string

Model name

osVersion
string

OS version

product
string

Product name

screenHeight
int16

Screen height

screenWidth
int16

Screen width

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.1.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/clients/id/linked-devices \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/clients/id/linked-devices',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/clients/id/linked-devices")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/clients/id/linked-devices");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/clients/id/linked-devices"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Link client device by client uuid

Add client device by his uuid. Every client is allowed to have many different devices.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_CLIENT scope assigned
or you have to be logged in as user and have ROLE_CLIENT_SHOW role assigned.

 
posthttps://api.synerise.com/v4/clients/by-uuid/uuid/linked-devices

Path Params

uuid
uuid
required

Client's uuid

Body Params

deviceId
string
required

Unique device ID How to get it on Android and on iOS

registrationId
string
type
string
required
bluetoothAddress
string

Bluetooth interface address (eg. 00:11:22:33:FF:EE)

macAddress
string

WiFi card MAC address (eg. 00:11:22:33:FF:EE)

manufacturer
string

Manufacturer name

model
string

Model name

osVersion
string

OS version

product
string

Product name

screenHeight
int16

Screen height

screenWidth
int16

Screen width

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.1.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/clients/by-uuid/uuid/linked-devices \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/clients/by-uuid/uuid/linked-devices',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/clients/by-uuid/uuid/linked-devices")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/clients/by-uuid/uuid/linked-devices");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/clients/by-uuid/uuid/linked-devices"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Get client geographical data

Get client geographical data.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_CLIENT scope assigned
or you have to be logged in as user and have ROLE_CLIENT_SHOW role assigned.

 
gethttps://api.synerise.com/v4/clients/id/geographical-data

Path Params

id
int64
required

Client ID

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request GET \
  --url https://api.synerise.com/v4/clients/id/geographical-data \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.synerise.com/v4/clients/id/geographical-data',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/clients/id/geographical-data")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.synerise.com/v4/clients/id/geographical-data");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/clients/id/geographical-data"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Get client

Get client data by client ID.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_CLIENT scope assigned
or you have to be logged in as user and have ROLE_CLIENT_SHOW role assigned.

 
gethttps://api.synerise.com/v4/clients/id

Path Params

id
int64
required

Client ID

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request GET \
  --url https://api.synerise.com/v4/clients/id \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.synerise.com/v4/clients/id',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/clients/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.synerise.com/v4/clients/id");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/clients/id"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Update client

Update client data by ID.
If you don't have a value for a field - don't send it at all, because sending null may remove existing value.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_CLIENT scope assigned
or you have to be logged in as user and have ROLE_CLIENT_EDIT role assigned.

 
posthttps://api.synerise.com/v4/clients/id

Path Params

id
int64
required

Client ID

Body Params

clientId
int64

Client ID

email
email

Email address

phone
string

Phone number

customId
string

Your custom identifier of this client (e.g. from the external system)

firstName
string

First name

lastName
string

Last name

displayName
string

Name used for display, e.g. nickname

uuid
uuid

Unique identifier of an anonymous client

avatarUrl
string

URL of the avatar image

birthDate
date

Birth date, e.g. 1986-04-26

company
string

Company name

city
string

City of residence

address
string

Address of residence

zipCode
string

Zip code

province
string

Province name

countryCode
string

Country code, e.g. "pl" (ISO 3166-1 alpha-2)

sex
string

Sex

agreements
object
 
agreements.email
boolean

Email communication agreement

agreements.sms
boolean

SMS communication agreement

agreements.push
boolean

Push communication agreement

agreements.bluetooth
boolean

Bluetooth communication agreement (for mobile)

agreements.rfid
boolean

RFID communication agreement (for mobile)

agreements.wifi
boolean

WiFi scanning agreement (for mobile)

attributes
object

Custom attributes (you can send us whatever you want)

 
tags
array of strings

List of tags to assign

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/clients/id \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/clients/id',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/clients/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/clients/id");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/clients/id"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Delete client

Delete client by ID.
We use it internally as an update, and enqueue in the same way as any other modification.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_CLIENT scope assigned
or you have to be logged in as user and have ROLE_CLIENT_DELETE role assigned.

 
deletehttps://api.synerise.com/v4/clients/id

Path Params

id
int64
required

Client ID

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request DELETE \
  --url https://api.synerise.com/v4/clients/id \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'DELETE',
  url: 'https://api.synerise.com/v4/clients/id',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/clients/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("DELETE", "https://api.synerise.com/v4/clients/id");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/clients/id"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("DELETE", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Clients listing

This endpoint allows you to list clients with live filtering, sorting and pagination.
If you want to materialize set of clients you can use Create client list endpoint.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_CLIENT scope assigned
or you have to be logged in as user and have ROLE_CLIENT_SHOW role assigned.

 
gethttps://api.synerise.com/v4/clients

Query Params

sortBy
string

Client attribute by which listing will be sorted

sortOrder
string
pageIndex
integer

One based page index

pageSize
integer

Page size

filters[anonymous]
boolean

Filter by clients anonymity. Not sending this value will return listing with all clients. True - only anonymous, false - only identified

filters[firstName]
string

Filter by clients first name

filters[lastName]
string

Filter by clients last name

filters[email]
string

Filter by clients last email

filters[city]
string

Filter by clients city

filters[phone]
string

Filter by clients phone

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.1.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request GET \
  --url https://api.synerise.com/v4/clients \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.synerise.com/v4/clients',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/clients")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.synerise.com/v4/clients");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/clients"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Create client

Create a new client record, if no identifier has been assigned for him before in Synerise.
If you don't have a value for a field - don't send it at all.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_CLIENT scope assigned
or you have to be logged in as user and have ROLE_CLIENT_CREATE role assigned.

 
posthttps://api.synerise.com/v4/clients

Body Params

email
email

Email address

phone
string

Phone number

customId
string

Your custom identifier of this client (e.g. from the external system)

firstName
string

First name

lastName
string

Last name

displayName
string

Name used for display, e.g. nickname

uuid
uuid

Unique identifier of an anonymous client

avatarUrl
string

URL of the avatar image

birthDate
date

Birth date, e.g. 1986-04-26

company
string

Company name

city
string

City of residence

address
string

Address of residence

zipCode
string

Zip code

province
string

Province name

countryCode
string

Country code, e.g. "pl" (ISO 3166-1 alpha-2)

sex
string

Sex

agreements
object

Set of marketing agreements

 
agreements.email
boolean

Email communication agreement

agreements.sms
boolean

SMS communication agreement

agreements.push
boolean

Push communication agreement

agreements.bluetooth
boolean

Bluetooth communication agreement (for mobile)

agreements.rfid
boolean

RFID communication agreement (for mobile)

agreements.wifi
boolean

WiFi scanning agreement (for mobile)

attributes
object

Custom attributes (you can send us whatever you want)

 
tags
array of strings

List of tags to assign

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/clients \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/clients',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/clients")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/clients");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/clients"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Get client list

Get a definition of a client list by its ID. Useful e.g. to check it's expiration time.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_CLIENT scope assigned
or you have to be logged in as user and have ROLE_CLIENT_SHOW role assigned.

 
gethttps://api.synerise.com/v4/clients/list/id

Path Params

id
uuid
required

Client list ID

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request GET \
  --url https://api.synerise.com/v4/clients/list/id \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.synerise.com/v4/clients/list/id',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/clients/list/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.synerise.com/v4/clients/list/id");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/clients/list/id"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Create client list

Synerise is able to process millions of clients. Every segment, tag, or other aggregates could be bound to
thousands of clients. These assignments may change in time, though. Casual implementation of pagination would make
you effectively unable to capture the state of a list in a given moment in time. Therefore we decided, that every
time you want to make a list from query, we materialize the set of client IDs which would have been returned at that
moment and make you able to fetch whole clients from that list by using
Find clients by list endpoint.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_CLIENT scope assigned
or you have to be logged in as user and have ROLE_CLIENT_SHOW role assigned.

 
posthttps://api.synerise.com/v4/clients/list

Body Params

segment
int32
required

The ID of the segment (for now it is the only supported parameter, but there will be more)

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/clients/list \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/clients/list',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/clients/list")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/clients/list");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/clients/list"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Register client

Use this, to allow clients to register.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_CLIENT_ACCOUNT scope assigned.

 
posthttps://api.synerise.com/v4/clients/registered

Body Params

address
string

Address of residence

agreements
object
 
agreements.email
boolean

Email communication agreement

agreements.sms
boolean

SMS communication agreement

agreements.push
boolean

Push communication agreement

agreements.bluetooth
boolean

Bluetooth communication agreement (for mobile)

agreements.rfid
boolean

RFID communication agreement (for mobile)

agreements.wifi
boolean

WiFi scanning agreement (for mobile)

attributes
object
 
city
string

City of residence

company
string

Company name

countryCode
string

Country code, e.g. "pl" (ISO 3166-1 alpha-2)

customId
string

Your custom identifier of this client (e.g. from the external system)

email
string
required

Email address

firstName
string

First name

lastName
string

Last name

password
string
required

Password

phone
string

Phone number

province
string

Province name

sex
string

Sex

tags
array of strings

List of tags to assign

zipCode
string

Zip code

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/clients/registered \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/clients/registered',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/clients/registered")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/clients/registered");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/clients/registered"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Password reset confirmation

Use this, to allow clients to confirm password reset requests. They should send received token and new password.
For requesting password reset, check Password reset confirmation.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_CLIENT_ACCOUNT scope assigned.

 
posthttps://api.synerise.com/v4/clients/password-reset/confirmation

Body Params

password
string
required

Password

token
string
required

Token from reset request

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/clients/password-reset/confirmation \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/clients/password-reset/confirmation',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/clients/password-reset/confirmation")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/clients/password-reset/confirmation");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/clients/password-reset/confirmation"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Request password reset

Use this, to allow clients to send requests for resetting their passwords. They will receive a token on the specified email address.
For confirming request, check Password reset confirmation.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_CLIENT_ACCOUNT scope assigned.

 
posthttps://api.synerise.com/v4/clients/password-reset/request

Body Params

email
email
required

Email address

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/clients/password-reset/request \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/clients/password-reset/request',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/clients/password-reset/request")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/clients/password-reset/request");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/clients/password-reset/request"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Get client scoring data

Get client scroring data.

Note that this endpoint is available from version 4.1.0

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_CLIENT scope assigned
or you have to be logged in as user and have ROLE_CLIENT_SHOW role assigned.

 
gethttps://api.synerise.com/v4/clients/id/scoring

Path Params

id
int64
required

Client ID

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request GET \
  --url https://api.synerise.com/v4/clients/id/scoring \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.synerise.com/v4/clients/id/scoring',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/clients/id/scoring")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.synerise.com/v4/clients/id/scoring");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/clients/id/scoring"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Get all tags

Get all possible client tags that can be associated.

Note that this endpoint is available from version 4.1.0

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_CLIENT scope assigned
or you have to be logged in as user and have ROLE_CLIENT_SHOW role assigned.

 
gethttps://api.synerise.com/v4/clients/tags

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request GET \
  --url https://api.synerise.com/v4/clients/tags \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.synerise.com/v4/clients/tags',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/clients/tags")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.synerise.com/v4/clients/tags");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/clients/tags"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Get account information

Use this, to allow clients to check account information.

Note that this endpoint is available from version 4.0.2.

In order to use this endpoint, you have to be logged in as client.

 
gethttps://api.synerise.com/v4/my-account/personal-information

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request GET \
  --url https://api.synerise.com/v4/my-account/personal-information \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.synerise.com/v4/my-account/personal-information',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/my-account/personal-information")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.synerise.com/v4/my-account/personal-information");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/my-account/personal-information"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Update account information

Use this, to allow clients to update account information.

Note that this endpoint is available from version 4.0.2.

In order to use this endpoint, you have to be logged in as client.

 
posthttps://api.synerise.com/v4/my-account/personal-information

Body Params

address
string

Address of residence

birthDate
date

Birth date, e.g. 1986-04-26

city
string

City of residence

company
string

Company name

countryCode
string

Country code, e.g. "pl" (ISO 3166-1 alpha-2)

displayName
string

Name used for display, e.g. nickname

firstName
string

First name

lastName
string

Last name

phoneNumber
string

Phone number

province
string

Province name

sex
string

Sex

zipCode
string

Zip code

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/my-account/personal-information \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/my-account/personal-information',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/my-account/personal-information")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/my-account/personal-information");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/my-account/personal-information"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Get transactions list

Use this, to allow clients to check their transactions.

In order to use this endpoint, you have to be logged in as client.

 
gethttps://api.synerise.com/v4/my-account/transactions

Query Params

time[from]
date-time

time[from]

time[to]
date-time

time[to]

limit
int32

limit

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request GET \
  --url https://api.synerise.com/v4/my-account/transactions \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.synerise.com/v4/my-account/transactions',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/my-account/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.synerise.com/v4/my-account/transactions");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/my-account/transactions"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results

Events allow you to track your clients' activities and are extremely helpful in the management process. Each event contains name, precise date when the event took place, and sometimes additional data. By using and checking events, you can get various useful information about your customers.

For instance, you can check if the client opened your mail, made a purchase or left a cart. Events can be also used in automation process, e.g. you can automatically send an SMS to the customer that entered your shop. Use this powerful component to improve your knowledge about customers and provide them better services.

Live Stream shows you events of all your clients in real time. You can also check specified client's events, by visiting CRM and clicking on the chosen customer.

Suggest Edits

Record 'client added product to cart' event

Record a 'client added product to cart' event. If you don't have a value for a field - don't send it at all.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_EVENT scope assigned.

 
posthttps://api.synerise.com/v4/events/added-to-cart

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/events/added-to-cart \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/events/added-to-cart',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/events/added-to-cart")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/events/added-to-cart");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/events/added-to-cart"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Record 'client added product to favorites' event

Record a 'client added product to favorites' event. If you don't have a value for a field - don't send it at all.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_EVENT scope assigned.

 
posthttps://api.synerise.com/v4/events/added-to-favorites

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/events/added-to-favorites \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/events/added-to-favorites',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/events/added-to-favorites")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/events/added-to-favorites");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/events/added-to-favorites"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Get events

If time[from] and time[to] have been provided, difference between them should be less than 7 days.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_EVENT scope assigned.

 
gethttps://api.synerise.com/v4/events/all

Query Params

time[from]
date-time

Return only events that occurred later than given time. If provided, should be earlier than time[to].

time[to]
date-time

Return only events that occurred earlier than given time. If provided, should be later than time[from].

limit
integer

How many events should be returned.

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request GET \
  --url https://api.synerise.com/v4/events/all \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.synerise.com/v4/events/all',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/events/all")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.synerise.com/v4/events/all");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/events/all"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Record 'client appeared in location' event

Record a 'client appeared in location' event. If you don't have a value for a field - don't send it at all.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_EVENT scope assigned.

 
posthttps://api.synerise.com/v4/events/appeared-in-location

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/events/appeared-in-location \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/events/appeared-in-location',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/events/appeared-in-location")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/events/appeared-in-location");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/events/appeared-in-location"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Record many events in a batch

Records a batch of events.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_EVENT scope assigned.

 
posthttps://api.synerise.com/v4/events/batch

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.1.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/events/batch \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/events/batch',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/events/batch")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/events/batch");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/events/batch"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Get client events

If time[from] and time[to] have been provided, difference between them should be less than 7 days.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_EVENT scope assigned.

 
gethttps://api.synerise.com/v4/events/by-client/id

Path Params

id
int64
required

Client ID

Query Params

time[from]
date-time

Return only events that occurred later than given time. If provided, should be earlier than time[to].

time[to]
date-time

Return only events that occurred earlier than given time. If provided, should be later than time[from].

limit
integer

How many events should be returned.

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request GET \
  --url https://api.synerise.com/v4/events/by-client/id \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.synerise.com/v4/events/by-client/id',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/events/by-client/id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.synerise.com/v4/events/by-client/id");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/events/by-client/id"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Record 'client cancelled push' event

Record a 'client cancelled push' event. It is used for push message interaction tracking.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_EVENT scope assigned.

 
posthttps://api.synerise.com/v4/events/push/cancelled

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.1.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/events/push/cancelled \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/events/push/cancelled',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/events/push/cancelled")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/events/push/cancelled");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/events/push/cancelled"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Record 'client cancelled transaction' event

Record a 'client cancelled transaction' event. If you don't have a value for a field - don't send it at all.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_EVENT scope assigned.

 
posthttps://api.synerise.com/v4/events/cancelled-transaction

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/events/cancelled-transaction \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/events/cancelled-transaction',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/events/cancelled-transaction")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/events/cancelled-transaction");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/events/cancelled-transaction"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Record 'client clicked push' event

Record a 'client clicked push' event. It is used for push message interaction tracking.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_EVENT scope assigned.

 
posthttps://api.synerise.com/v4/events/push/clicked

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.1.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/events/push/clicked \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/events/push/clicked',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/events/push/clicked")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/events/push/clicked");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/events/push/clicked"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Record 'client completed transaction' event

Record a 'client completed transaction' event. If you don't have a value for a field - don't send it at all.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_EVENT scope assigned.

 
posthttps://api.synerise.com/v4/events/completed-transaction

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/events/completed-transaction \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/events/completed-transaction',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/events/completed-transaction")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/events/completed-transaction");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/events/completed-transaction"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Record custom event

Record a custom event. If you don't have a value for a field - don't send it at all.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_EVENT scope assigned.

 
posthttps://api.synerise.com/v4/events/custom

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/events/custom \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/events/custom',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/events/custom")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/events/custom");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/events/custom"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Record 'client hit timer' event

Record a 'client hit timer' event. This could be used for profiling or activity time monitoring - you can send "hit timer" when your client
starts doing something and send it once again when he finishes, but this time with different time signature. Then you can use
our analytics engine to measure e.g. average activity time.

If you don't have a value for a field - don't send it at all.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_EVENT scope assigned.

 
posthttps://api.synerise.com/v4/events/hit-timer

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/events/hit-timer \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/events/hit-timer',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/events/hit-timer")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/events/hit-timer");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/events/hit-timer"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Record 'client logged in' event

Record a 'client logged in' event. If you don't have a value for a field - don't send it at all.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_EVENT scope assigned.

 
posthttps://api.synerise.com/v4/events/logged-in

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/events/logged-in \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/events/logged-in',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/events/logged-in")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/events/logged-in");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/events/logged-in"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Record 'client logged out' event

Record a 'client logged out' event. If you don't have a value for a field - don't send it at all.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_EVENT scope assigned.

 
posthttps://api.synerise.com/v4/events/logged-out

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/events/logged-out \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/events/logged-out',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/events/logged-out")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/events/logged-out");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/events/logged-out"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Record 'client registered' event

Record a 'client registered' event. If you don't have a value for a field - don't send it at all.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_EVENT scope assigned.

 
posthttps://api.synerise.com/v4/events/registered

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/events/registered \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/events/registered',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/events/registered")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/events/registered");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/events/registered"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Record 'client removed product from cart' event

Record a 'client removed product from cart' event. If you don't have a value for a field - don't send it at all.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_EVENT scope assigned.

 
posthttps://api.synerise.com/v4/events/removed-from-cart

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/events/removed-from-cart \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/events/removed-from-cart',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/events/removed-from-cart")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/events/removed-from-cart");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/events/removed-from-cart"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Record 'client searched' event

Record a 'client searched' event. If you don't have a value for a field - don't send it at all.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_EVENT scope assigned.

 
posthttps://api.synerise.com/v4/events/searched

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/events/searched \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/events/searched',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/events/searched")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/events/searched");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/events/searched"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Record 'client shared' event

Record a 'client shared' event. If you don't have a value for a field - don't send it at all.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_EVENT scope assigned.

 
posthttps://api.synerise.com/v4/events/shared

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/events/shared \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/events/shared',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/events/shared")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/events/shared");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/events/shared"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Record 'client viewed push' event

Record a 'client viewed push' event. It is used for push message interaction tracking.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_EVENT scope assigned.

 
posthttps://api.synerise.com/v4/events/push/viewed

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.1.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/events/push/viewed \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/events/push/viewed',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/events/push/viewed")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/events/push/viewed");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/events/push/viewed"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Record 'client visited screen' event

Record a 'client visited screen' event. This could be used for mobile screen usage tracking.

If you don't have a value for a field - don't send it at all.

In order to use this endpoint, you have to be logged in as business profile and use Api Key, which has REALM_EVENT scope assigned.

 
posthttps://api.synerise.com/v4/events/visited-screen

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.0.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/events/visited-screen \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/events/visited-screen',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/events/visited-screen")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/events/visited-screen");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/events/visited-screen"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

mobile content

 

Mobile content related endpoints are used as a content management system for mobile applications. By using them you're able to create some mobile screens through the API and retrieve them using our SDK inside your mobile application. The most important aspect of this feature is the fact, that your developers integrate your application with Synerise only once and you may edit its contents many times without the need to complete the whole release cycle.

Suggest Edits

Get bucket information by name

Get bucket information by name

Note that this endpoint is available from version 4.1.0

Bucket is the primary storage unit for your content. You can name your buckets according
to your preference. The bucket name could possibly be bound to the version of your application.
By using this convention you enable yourself to serve different versions of content according
to the application version.

In order to use this endpoint, you have to be logged in as business profile.

 
gethttps://api.synerise.com/v4/mobile-content/bucket/name

Path Params

name
string
required

Bucket name

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.1.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request GET \
  --url https://api.synerise.com/v4/mobile-content/bucket/name \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.synerise.com/v4/mobile-content/bucket/name',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/mobile-content/bucket/name")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.synerise.com/v4/mobile-content/bucket/name");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/mobile-content/bucket/name"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Create bucket by name

Create bucket by name

Note that this endpoint is available from version 4.1.0

In order to use this endpoint, you have to be logged in as business profile.

 
puthttps://api.synerise.com/v4/mobile-content/bucket/name

Path Params

name
string
required

Bucket name

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.1.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request PUT \
  --url https://api.synerise.com/v4/mobile-content/bucket/name \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'PUT',
  url: 'https://api.synerise.com/v4/mobile-content/bucket/name',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/mobile-content/bucket/name")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("PUT", "https://api.synerise.com/v4/mobile-content/bucket/name");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/mobile-content/bucket/name"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("PUT", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Get onboarding from bucket by name

Get onboarding from bucket by name

Note that this endpoint is available from version 4.1.0

Onboarding is like tutorial for the application. It consists of series of screens which introduce
the application to the user.

In order to use this endpoint, you have to be logged in as business profile.

 
gethttps://api.synerise.com/v4/mobile-content/bucket/name/by-type/onboarding

Path Params

name
string
required

Bucket name

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.1.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request GET \
  --url https://api.synerise.com/v4/mobile-content/bucket/name/by-type/onboarding \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.synerise.com/v4/mobile-content/bucket/name/by-type/onboarding',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/mobile-content/bucket/name/by-type/onboarding")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.synerise.com/v4/mobile-content/bucket/name/by-type/onboarding");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/mobile-content/bucket/name/by-type/onboarding"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Create onboarding in bucket by name

Create onboarding in bucket by name

Note that this endpoint is available from version 4.1.0

In order to use this endpoint, you have to be logged in as business profile.

 
posthttps://api.synerise.com/v4/mobile-content/bucket/name/by-type/onboarding

Path Params

name
string
required

Bucket name

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.1.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/mobile-content/bucket/name/by-type/onboarding \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/mobile-content/bucket/name/by-type/onboarding',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/mobile-content/bucket/name/by-type/onboarding")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://api.synerise.com/v4/mobile-content/bucket/name/by-type/onboarding");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/mobile-content/bucket/name/by-type/onboarding"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("POST", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Get welcome screen from bucket by name

Get welcome screen from bucket by name

Note that this endpoint is available from version 4.1.0

Welcome screen is just a screen displayed just after opening the application.

In order to use this endpoint, you have to be logged in as business profile.

 
gethttps://api.synerise.com/v4/mobile-content/bucket/name/by-type/welcome-screen

Path Params

name
string
required

Bucket name

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.1.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request GET \
  --url https://api.synerise.com/v4/mobile-content/bucket/name/by-type/welcome-screen \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'GET',
  url: 'https://api.synerise.com/v4/mobile-content/bucket/name/by-type/welcome-screen',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/mobile-content/bucket/name/by-type/welcome-screen")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Authorization'
request["api-version"] = 'Api-Version'
request["accept"] = 'Accept'
request["content-type"] = 'Content-Type'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://api.synerise.com/v4/mobile-content/bucket/name/by-type/welcome-screen");
xhr.setRequestHeader("authorization", "Authorization");
xhr.setRequestHeader("api-version", "Api-Version");
xhr.setRequestHeader("accept", "Accept");
xhr.setRequestHeader("content-type", "Content-Type");

xhr.send(data);
import requests

url = "https://api.synerise.com/v4/mobile-content/bucket/name/by-type/welcome-screen"

headers = {
    'authorization': "Authorization",
    'api-version': "Api-Version",
    'accept': "Accept",
    'content-type': "Content-Type"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

Try the API to see results
Suggest Edits

Create welcome screen in bucket by name

Create welcome screen in bucket by name

Note that this endpoint is available from version 4.1.0

In order to use this endpoint, you have to be logged in as business profile.

 
posthttps://api.synerise.com/v4/mobile-content/bucket/name/by-type/welcome-screen

Path Params

name
string
required

Bucket name

Headers

Authorization
string
required

JWT token (prepended by the Bearer: string)

Api-Version
string
required

Requested api version, e.g. 4.1.

Accept
string
required

application/json

Content-Type
string
required

application/json

curl --request POST \
  --url https://api.synerise.com/v4/mobile-content/bucket/name/by-type/welcome-screen \
  --header 'accept: Accept' \
  --header 'api-version: Api-Version' \
  --header 'authorization: Authorization' \
  --header 'content-type: Content-Type'
var request = require("request");

var options = { method: 'POST',
  url: 'https://api.synerise.com/v4/mobile-content/bucket/name/by-type/welcome-screen',
  headers: 
   { 'content-type': 'Content-Type',
     accept: 'Accept',
     'api-version': 'Api-Version',
     authorization: 'Authorization' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://api.synerise.com/v4/mobile-content/bucket/