How to connect BaseLinker to Zendesk with an API token

By Jake Marsh · Updated

To connect BaseLinker to Zendesk, open Account & other > My account > API in BaseLinker, create a token or copy an existing one, then install Targwell for BaseLinker from the Zendesk Marketplace and paste it into BaseLinker API token. Zendesk keeps the token as a secure setting and sends it only to api.baselinker.com in the X-BLToken header. Agents never see it.

Steps

  1. Get the token. In BaseLinker, go to Account & other > My account > API and create a token. The token carries your BaseLinker account's access, so keep it in Zendesk only.
  2. Install Targwell and start the 14-day trial.
  3. Paste the token into BaseLinker API token.
  4. Optional: label and brands. Account label is the name agents see (default: BaseLinker). Account brands lists the Zendesk brand ids whose tickets open this account first; the id is in the brand's address under Admin Center > Account > Brand management.
  5. Optional: more accounts. For accounts 2 and 3, fill in the label to turn one on, then paste its token.
  6. Optional: Open in BaseLinker link. Paste your order card address with {id} where the order number goes, for example https://panel-e.baselinker.com/orders.php#order:{id}.
  7. Optional: language. The interface follows each agent's Zendesk language. Set Language to en, pl or de to fix it for everyone.
  8. Open a ticket from a customer with BaseLinker orders to check it works.

The 100 requests a minute limit

BaseLinker allows 100 API requests a minute, shared with every integration on your account, Targwell included.

WhenRequests Targwell makes
Sidebar opensThe status list and order sources, once
For each requester emailOne order id list and one order read
For each order number in the ticketOne read
An agent opens an orderIts shipments

If the limit is used up, the sidebar says so. A refused call is reported, never retried. BaseLinker's API log shows which integration used the limit.

Error messages and fixes

MessageFix
BaseLinker did not accept the API tokenCreate a new token in BaseLinker and paste it into the settings
Limit of 100 requests a minute is used upWait a minute, then check BaseLinker's API log for the busiest integration
No orders for this requesterThe buyer email differs (often a marketplace relay); look the order up by number
The order card link is not usedIt must be an https address on baselinker.com or base.com with {id}
Could not read the account brands settingUse Zendesk brand ids separated by commas

What it costs

Targwell for BaseLinker is $9 a month per agent on the Standard plan, billed monthly by Zendesk, with a 14-day free trial. Zendesk asks for a card at install. Nothing is installed in BaseLinker. The Targwell documentation covers matching and actions.

Targwell for BaseLinker

Allegro, Amazon, eBay and Kaufland orders from BaseLinker in the ticket, matched by email. $9/agent. $9 a month per agent.

Install Targwell for BaseLinkerAbout Targwell for BaseLinkerDocumentation

Questions

Can I give Targwell a read-only token?

The token carries your BaseLinker account's access. To keep agents read-only, leave Allow status changes off, turn off adding to seller comments, or keep Who may take actions at admin.

Does Targwell slow down my other BaseLinker integrations?

It shares the same 100 requests a minute. It reads a handful per ticket, loads shipments only when an order is opened, and never retries a refused call.

Can I connect two BaseLinker accounts to one Zendesk?

Yes, up to three. Each gets its own label, token and brands, and agents switch accounts in the sidebar.

What should I do when I stop using it?

Uninstall Targwell in Zendesk, which removes its settings and the token, then delete the token in BaseLinker.

More Targwell for BaseLinker guides

More Zendesk guides