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

parcelLab (BYOK) — connector documentation

  • MCP endpoint: https://byok-parcellab.connectorbay.com/mcp
  • REST API: POST https://byok-parcellab.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://byok-parcellab.connectorbay.com/openapi.json
  • Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
  • Authentication: your own parcelLab Encoded API token (base64 of account_id:token from the parcelLab portal), sent in the X-Upstream-Key header of every request (never stored, logged or cached)
  • Health: https://byok-parcellab.connectorbay.com/health · Tool schemas: https://byok-parcellab.connectorbay.com/tools.json
  • Publisher: Unify Dynamics LLC · connectorbay.com/byok-parcellab · agent@connectorbay.com

What parcelLab (BYOK) is for

parcelLab (BYOK) lets an AI assistant read your own parcelLab data through the parcelLab API with a key you supply (Encoded API token (base64 of account_id:token from the parcelLab portal)). Read-only: 7 tools (list_orders, get_order, list_return_registrations, get_return_registration, get_return_status, list_return_configurations, get_return_configuration). 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 api.parcellab.com. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by parcelLab. parcelLab 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:

  • "Which parcelLab orders were shipped to Germany this week?"
  • "What articles were in order 100234 and what is its status?"
  • "Which returns are waiting for approval?"
  • "What is in return ret-1 and where is its label?"
  • "Has the return ret-1 arrived at the warehouse?"
  • "Which returns portals are set up and how long can items be returned?"

What it does

  • list_orders: List tracked orders with order number, status, channel, totals, currency, country, delivery method, announced delivery window and order date. Recipient and address data are left out.
  • get_order: Get one tracked order by order number or external ID: status, totals, currency, delivery window, cancellation and the ordered articles (SKU, name, quantity, price). Recipient and address data are left out.
  • list_return_registrations: List return registrations with status, reason, courier, original order, order totals, item count, refund method and timestamps. Filter by status, dates, order, tracking number or returns portal. Customer names, emails and addresses are left out.
  • get_return_registration: Get one return registration by external ID: status, order totals, shipping and delivery dates, refund method, returned articles, return labels and timestamps. Customer contact data is left out.
  • get_return_status: Get the live status of one return: stage (registered, label ready, in transit, received, complete and so on), whether labels are available, whether it can be cancelled, and refund information.
  • list_return_configurations: List returns portal configurations with code, client, courier mappings, rules ID and returnable periods (trial, grace and warranty days).
  • get_return_configuration: Get one returns portal configuration with its code, courier mappings, rules ID and returnable periods.

BYOK key

You bring your own parcelLab Encoded API token (base64 of account_id:token from the parcelLab portal) (https://docs.parcellab.com/). 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 api.parcellab.com 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 parcelLab API (api.parcellab.com) with a BYOK key; documentation: https://docs.parcellab.com/. 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 parcelLab. parcelLab 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 parcelLab account.

Built for: Worldwide. Languages: English.