---
title: "Update Event Tracker"
method: PUT
path: "/event_trackers/{id}"
tags: ["Event Trackers"]
---

# Update Event Tracker

`PUT /event_trackers/{id}`

## Request

- Base URL: `https://open.shopline.io/v1`
- URL: `https://open.shopline.io/v1/event_trackers/{id}`
- Auth: HTTP bearer

To update an event tracker with open API<br>透過open API更新第三方事件追蹤

## Path parameters

- `id` string, required

## Query parameters

- `version` string

## Request body

- object
  - `event_key` 'tiktok' | 'facebook_standard_pixel', required: The platform of tracking services. The event key must match with the existing record<br> 追蹤平台。event_key 必須與現在的一致<br>
  - `config_data` object, required: Config data, each event_key has its own config<br> 設定，每個event_key都有各自的config
    - `tracking_code` string, required: Tracking code<br>追蹤碼
    - `access_token` string, required: Access token
    - `dynamic_remarketing` boolean: Dynamic Remarketing, specific for some kinds of event trackers.
    - `single_variation` boolean: Single Variation, specific for some kinds of event trackers.
    - `unique_ids` boolean: Unique IDs, specific for some kinds of event trackers.

## Response `200`

OK

- EventTrackers
  - `items` EventTracker[]
    - `id` string: ID
    - `event_type` 'loaded_home_page' | 'added_product_to_cart' | 'loaded_checkout_page' | 'placed_an_order' | 'loaded_any_page'
    - `event_key` 'tiktok' | 'facebook_standard_pixel': The platform of tracking services
    - `status` 'active': The status of the event tracker
    - `created_at` string: created time
    - `updated_at` string: updated time
    - `config_data` object: Config data, each event has its own config key
      - `dynamic_remarketing` boolean: false by default
      - `single_variation` boolean: false by default
      - `unique_ids` boolean: false by default
      - `tracking_code` string: tracking code
      - `access_token` string: for tiktok
  - `pagination` Paginatable
    - `current_page` integer: The current page number<br>當前分頁
    - `per_page` integer: Number of result per page<br>每頁顯示 n 筆資料<br>(Default: 24)
    - `total_count` integer: Number of result in total<br>資料總量
    - `total_pages` integer: Number of pages in total<br>總頁數量

## Other responses

- `401`: Bad authentication
- `404`: Not found error
- `422`: Unprocessable entity
- `500`: Server error

## Changes

- **2026-11-03** `d2518391b149`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shoplineapp/apis/shopline-open-api/changes/event_trackers/:id/put.md)

---

[API](https://skmtc.dev/shoplineapp/apis/shopline-open-api.md) - [All operations](https://skmtc.dev/shoplineapp/apis/shopline-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shoplineapp/apis/shopline-open-api/revisions/d2518391b149?raw)