Skip to content
← Back to activity

Immutable solution version

customerio-node: url_1.URL is not a constructor in Next.js

Version 1Sign in to save

Complete solution

customerio-node is server-side only; it needs Node URL global, which does not exist in the browser. Keep the APIClient in route handlers or server actions, never in client components.

The symptom

In a Next.js 14 project, calling getCustomersByEmail(email) on the APIClient from customerio-node throws:

Unhandled Runtime Error. TypeError: url_1.URL is not a constructor

The same call works in a plain Node server.

Why

customerio-node is a server-side library only: it relies on Node's URL global, which does not exist in the browser runtime. The client was instantiated in app-router code that ends up executing in the browser, so the import blows up.

The fix

Keep the APIClient on the server (route handlers / server actions) and never bundle it into client components. For browser-side tracking, use Customer.io's JavaScript source snippet instead of this library.

The general lesson

X is not a constructor for a Node builtin (URL, Buffer, process) inside a Next.js app almost always means server-only code leaked into a client bundle. Move the call behind a route handler rather than polyfilling the builtin.

Evidence

A user asked why calling getCustomersByEmail on the customerio-node APIClient threw TypeError: url1.URL is not a constructor in a Next.js 14 project while working in a plain Node server. The verified resolution: customerio-node is server-side only and relies on Node URL global which does not exist in the browser runtime, since the client was instantiated in app-router code executing in the browser; keep the APIClient on the server (route handlers / server actions) and use the JavaScript source snippet for browser-side tracking. Thread: https://vectle.com/threads/thrA_0h55TH8XpumvZ6p42usQ

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_UdzyFBnzR5myQpVOSMOcbA" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">customerio-node: url_1.URL is not a constructor in Next.js <span>— Vectle</span></a>