Create protection



Create a new brand protection.


  • Authorization string
    The Autorization header must start with “Bearer ” followed by the session ID. Example:”Autorization: Bearer b0f13a3c01d9cce2a9a44cd729f81c26″
  • Content-type string
    Content type of the request Only “application/json” is accepted



  • label string (256)
    Brand main label
  • prod string (20)
    Brand protection product ID (See brand protection products)
  • duration integer
    Period of validity in years
  • idOwner string (12)
    ID of the owner contact (with “isOwner=1”)
  • type string (3)
    Brand’s type
  • info array
    Array of strings containing brand datas

JSON example

    "info": {
  • idOwner must exist and belong the reseller.
  • idOwner must be a contact with isOwner=1
  • The type can take three different values :
    • SMD if your brand protection rely on a SMD file.
    • TM if your brand has a trademark.
    • ORG if your brand is an organization.
  • The array info is required to be filled with the following values if the type is not SMD:
    • NAME for the trademark or brand name.
    • NUMBER for the trademark or brand number.
    • JURISDICTION for the trademark or brand registry.

Common language examples

$ch = curl_init();
$body = array(
    "label" => "exampleLabel",
    "prod" => "ADULTBLOCK",
    "duration" => 1,
    "idOwner" => "IDOWN",
    "type" => "ORG",
    "info" => array(
        "NAME" => "test",
        "NUMBER" => "123456789",
        "JURISDICTION" => "example"
curl_setopt($ch, CURLOPT_URL,"");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer $sessionID", "Content-type: application/json"]);
curl_setopt($ch, CURlOPT_POSTFIELDS, json_encode($body));
$result = json_decode(curl_exec ($ch), true);
$status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close ($ch);
import java.util.Base64;
public class Example {
    public static void main(String args[]) throws Exception {
        String sessionID = "12345678";
        String body = "{\"label\":\"exampleLabel\",\"prod\":\"ADULTBLOCK\",\"duration\":\"1\",\"idOwner\":\"IDOWN\",\"type\":\"ORG\",\"info\": {\"NAME\":\"test\",\"NUMBER\":\"123456789\",\"JURISDICTION\":\"example\"}}";
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
			.method("POST", HttpRequest.BodyPublishers.ofString(body))
			.header("Content-Type", "application/json")
			.header("Accept-Language", "EN")
			.header("Authorization", "Bearer " + sessionID)
        HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
        String result = response.body().toString();
import json
import requests
url = ''
sessionId = "1234567"
headers = {"Authorization": "Bearer " + sessionId, "Content-Type": "application/json"}
data = {
    "info": {
response =, headers=headers, data=json.dumps(data))
curl -X POST \
-H 'Authorization: Bearer b0f13a3c01d9cce2a9a44cd729f81c26=' \
-H 'Content-type: application/json' \
-d '{"label":"exampleLabel","prod":"ADULTBLOCK","duration":"1","idOwner":"IDOWN","type":"ORG","INFO":{"NAME":"test","NUMBER":"123456789","JURISDICTION":"example"}}'