Be the first to get access to new connectors. Get early access →
ConnectorBay Early access

Giao Hang Tiet Kiem (BYOK) — connector documentation

  • MCP endpoint: https://byok-ghtk.connectorbay.com/mcp
  • REST API: POST https://byok-ghtk.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://byok-ghtk.connectorbay.com/openapi.json
  • Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
  • Authentication: your own Giao Hang Tiet Kiem GHTK API token, sent in the X-Upstream-Key header and the GHTK partner code (shop code or partner secret, sent as X-Client-Source) in X-Upstream-Key-2 of every request (never stored, logged or cached)
  • Health: https://byok-ghtk.connectorbay.com/health · Tool schemas: https://byok-ghtk.connectorbay.com/tools.json
  • Publisher: Unify Dynamics LLC · connectorbay.com/byok-ghtk · agent@connectorbay.com

What Giao Hang Tiet Kiem (BYOK) is for

Giao Hang Tiet Kiem (BYOK) lets an AI assistant read your own Giao Hang Tiet Kiem data through the Giao Hang Tiet Kiem API with a key you supply (GHTK API token). Read-only: 6 tools (get_order_status, calculate_shipping_fee, list_pickup_addresses, list_delivery_solutions, lookup_street_addresses, search_product_codes). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to services.giaohangtietkiem.vn. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Giao Hang Tiet Kiem. Giao Hang Tiet Kiem and its logos are trademarks of their owners and are used only to say which service the connector works with.

Ask your assistant things like:

  • "Where is GHTK order S1.A1.17373471?"
  • "How much does GHTK charge to ship 1 kg from Ha Noi to Ho Chi Minh City?"
  • "What pickup addresses do I have at GHTK?"
  • "Which GHTK delivery solution packages can my shop use?"
  • "Which level-4 addresses does GHTK know on Doi Can street in Ba Dinh, Ha Noi?"
  • "What GHTK product code does my laptop have?"

What it does

  • get_order_status: Get the delivery status of one GHTK order by its GHTK label id or your own partner order id: status code and text, dates, fees, weight and COD amount (recipient name, phone and address are left out).
  • calculate_shipping_fee: Quote the GHTK shipping fee and insurance fee between a pickup and a delivery address by province, district and ward names (free to call; creates no order).
  • list_pickup_addresses: List the shop's saved GHTK pickup addresses (id, name and address) to use as pickup points.
  • list_delivery_solutions: List the optional delivery solution packages (extra goods-safety services) the shop can add to orders.
  • lookup_street_addresses: List GHTK's level-4 (street or place) address names within a province, district and ward or street, for special-address matching.
  • search_product_codes: Search the shop's products already known to GHTK by name and get their product codes, weight and value.

BYOK key

You bring your own Giao Hang Tiet Kiem GHTK API token (https://khachhang.giaohangtietkiem.vn/web/thong-tin-shop/cau-hinh-api). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to services.giaohangtietkiem.vn over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.

Data sources

Live from the Giao Hang Tiet Kiem API (services.giaohangtietkiem.vn) with a BYOK key; documentation: https://api.ghtk.vn/docs/submit-order/logistic-overview. Endpoints checked against that documentation on 2026-10-16.

What it is not

Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Giao Hang Tiet Kiem. Giao Hang Tiet Kiem and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your Giao Hang Tiet Kiem account.

Built for: Worldwide. Languages: English.