Add a Tag to a container

curl -X POST \
 "https://api.ocamba.com/v1/hood/containers/{container_id}/tags" \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My Tag Name",
  "status": "active",
  "integration_id": "<integration_id>",
  "integration_params": {
    "<parameter_name_1>": "<parameter_value_1>",
    "<parameter_name_2>": "<parameter_value_2>"
  },
  "target": {
    "element": "head",
    "action": "append"
  },
  "triggers": {
    "consent_initiation": false,
    "page_view": false,
    "page_load": false,
    "element_visibility": {
      "selector": ".class",
      "when_to_fire": "once-per-page",
      "min_on_screen_time": 200,
      "observe_dom_changes": true
    },
    "scroll_depth": {
      "horizontal": {
        "percentage": 75
      },
      "vertical": {
        "percentage": 50
      }
    },
    "form_submission": false,
    "exit_intent": false,
    "click_element": {
      "enabled": true,
      "element": "header"
    },
    "timer": 200,
    "custom_event": {
      "event": "my_event"
    },
    "require_all_triggers": false,
    "dom_content_ready": false
  },
  "filters": [
    {
      "variable": "<variable_id>",
      "op": "eq",
      "value": "<filter_value>",
      "filters": [
        {
          "variable": "<nested_variable_id>",
          "op": "contains",
          "value": "<nested_filter_value>"
        }
      ]
    }
  ],
  "group": "Group A"
}'

const url = 'https://api.ocamba.com/v1/hood/containers/{container_id}/tags';
const options = {
  method: 'POST',
  headers: {
    Authorization: "Bearer {TOKEN}",
    'Content-Type': "application/json"
  },
  body: JSON.stringify(
    {
      "name": "My Tag Name",
      "status": "active",
      "integration_id": "<integration_id>",
      "integration_params": {
        "<parameter_name_1>": "<parameter_value_1>",
        "<parameter_name_2>": "<parameter_value_2>"
      },
      "target": {
        "element": "head",
        "action": "append"
      },
      "triggers": {
        "consent_initiation": false,
        "page_view": false,
        "page_load": false,
        "element_visibility": {
          "selector": ".class",
          "when_to_fire": "once-per-page",
          "min_on_screen_time": 200,
          "observe_dom_changes": true
        },
        "scroll_depth": {
          "horizontal": {
            "percentage": 75
          },
          "vertical": {
            "percentage": 50
          }
        },
        "form_submission": false,
        "exit_intent": false,
        "click_element": {
          "enabled": true,
          "element": "header"
        },
        "timer": 200,
        "custom_event": {
          "event": "my_event"
        },
        "require_all_triggers": false,
        "dom_content_ready": false
      },
      "filters": [
        {
          "variable": "<variable_id>",
          "op": "eq",
          "value": "<filter_value>",
          "filters": [
            {
              "variable": "<nested_variable_id>",
              "op": "contains",
              "value": "<nested_filter_value>"
            }
          ]
        }
      ],
      "group": "Group A"
    }
  )
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

$ch = curl_init("https://api.ocamba.com/v1/hood/containers/{container_id}/tags");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer {TOKEN}",
  "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(
  [
    "name" => "My Tag Name",
    "status" => "active",
    "integration_id" => "<integration_id>",
    "integration_params" => [
      "<parameter_name_1>" => "<parameter_value_1>",
      "<parameter_name_2>" => "<parameter_value_2>"
    ],
    "target" => [
      "element" => "head",
      "action" => "append"
    ],
    "triggers" => [
      "consent_initiation" => false,
      "page_view" => false,
      "page_load" => false,
      "element_visibility" => [
        "selector" => ".class",
        "when_to_fire" => "once-per-page",
        "min_on_screen_time" => 200,
        "observe_dom_changes" => true
      ],
      "scroll_depth" => [
        "horizontal" => [
          "percentage" => 75
        ],
        "vertical" => [
          "percentage" => 50
        ]
      ],
      "form_submission" => false,
      "exit_intent" => false,
      "click_element" => [
        "enabled" => true,
        "element" => "header"
      ],
      "timer" => 200,
      "custom_event" => [
        "event" => "my_event"
      ],
      "require_all_triggers" => false,
      "dom_content_ready" => false
    ],
    "filters" => [
      [
        "variable" => "<variable_id>",
        "op" => "eq",
        "value" => "<filter_value>",
        "filters" => [
          [
            "variable" => "<nested_variable_id>",
            "op" => "contains",
            "value" => "<nested_filter_value>"
          ]
        ]
      ]
    ],
    "group" => "Group A"
  ]
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

Responses

201 Created

{
  "id": "1004057",
  "company_id": "6197120",
  "container_id": "59389",
  "status": "active",
  "integration_id": "10000",
  "name": "My Tag Name",
  "triggers": {
    "consent_initiation": false,
    "page_view": false,
    "page_load": false,
    "element_visibility": {
      "selector": ".class",
      "when_to_fire": "once-per-page",
      "min_on_screen_time": 200,
      "observe_dom_changes": true
    },
    "scroll_depth": {
      "horizontal": {
        "percentage": 75
      },
      "vertical": {
        "percentage": 50
      }
    },
    "form_submission": false,
    "exit_intent": false,
    "click_element": {
      "enabled": true,
      "element": "header"
    },
    "timer": 200,
    "custom_event": {
      "event": "my_event"
    },
    "require_all_triggers": false,
    "dom_content_ready": false
  },
  "filters": [
    {
      "variable": "5647",
      "op": "eq",
      "value": "Some-value",
      "filters": [
        {
          "variable": "5645",
          "op": "contains",
          "value": "Some-value"
        }
      ]
    }
  ],
  "group": "Group A",
  "target": {
    "element": "head",
    "action": "append"
  },
  "integration_params": {
    "<parameter_name_1>": "<parameter_value_1>",
    "<parameter_name_2>": "<parameter_value_2>"
  },
  "position": 1,
  "code": "<!-- Generated tag code will appear here -->",
  "deleted": 0,
  "create_time": "2021-10-29 12:47:00",
  "update_time": "2021-10-29 12:47:00"
}

400 Bad Request

{
  "code": 400,
  "title": "Bad request.",
  "message": "The request is not valid.",
  "trace_id": "99a84211-f73d-4ff8-acdf-eb3e06bb9d62"
}

500 Internal Server Error

{
  "code": 500,
  "title": "Internal server error.",
  "trace_id": "99a84211-f73d-4ff8-acdf-eb3e06bb9d62"
}