# @segment/analytics-node

> https://www.npmjs.com/package/@segment/analytics-node

Latest version **3.1.0** (published 2026-04-29) · MIT license · 0 weekly downloads

## Install

```sh
npm install @segment/analytics-node
pnpm add @segment/analytics-node
yarn add @segment/analytics-node
bun add @segment/analytics-node
```

## Health

**Score 60/100 (C)** — status: active.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 3.1.0 |
| Published | 2026-04-29 |
| First published | 2022-11-05 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=20 |
| Dependencies | 6 |
| Unpacked size | 284.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | harksingh, fhalim-segment, cfree, ldelossantos, hjoonpm, celine-segment, pmcanseco-segment, masira, amillet89, cholt002, av-segment, aghotikar, vikrant-segment, larryatsegment, scruwys1, kyliepedersen, jinapark, cdignam-segment, segmentio, jrupasinghe, lateefat, yash-twilio, sowjanyasegment, ebru.odok, ryanligon, lpediredla, brookstaylorjr, nithan-twilio, dean-huynh, wdbetts, n2parko, jayakrishnannair, rhall-twilio, karimkeshwani, tyson_segment, jgabe13, bgamwell, poojasegment, maryam.sharif, wally.tg, salolivares, erikdw, chenxiangzhang, justeen, mericsson, prayansh-segmentt, jeremylarkin, bsneed, danieljackins, segment-seth, sayan-das-in, james9446, priscilla.giatti, nlsun, drew-thompson, segment-jsingh, mcoulibali, andrius-segment, valerieernst, nithin-benny, ainatancinco, skondamuri, clintz.seg, replatero, slenin-twilio, csayuso, seanhan-segment, nevermore2022, ama0223, gilomer, andrew.hoyle, marcelopv, eric.rogner, kdharaiya, jon.anderson-at-segment.com, stacy.song, rexatsegment, nickaguilar, bradenbecker, reneewang, dan.lasky, sam.tapia, lnamba, vikramkumar19, mpriyad25, jeremy.parker, smidges, nageshgolem, sudojatin, pmaid, sethsegment, jair.aviles, manali-bhosale, elmoselyee, chtoombs, peterdemartini, vincen7tran, sujin0, lfdelossantos, emmy.byrne, felttrip, sa-jsooter, lluque-twilio, kevinburkesegment, afsha-nazim-seg, song4you, david.anusontarangkul.segment, jyim008, michaelghseg, aishikawaki, twjosiah, tanya.gupta.segment, sindhusegment, prabhnoor1997, chihchun-twilio, pmiller-twilio, vbatanov, simpixelated, mcullenmeyer, neeharikakondipati, arunlalam-segment, mschaszberger, shuvrajit9904, abhinavsureka, varadarajan-tw, immanoj, blangtwilio, jsh-wu, sethnutetwilio, rrivera-segment, segment-admin, bgillan, tcgilbert, mckern_segment, maneesh.dharma29, joetessy, dominicbarnes, mugelstad, jalexy12, pmunin, whaider_twilio, ariel.silvestri, shraddha-twilio, michelr, brandon.scott-segment, jfehrman.segment, prayansh-twilio, dangmai-segment, aaronklish, brianhumphreystwilio, rmukundan, ashwitha.bg, ryanrouleau-segment, funlu, tdibacco, fauzy.yy, nlubchenco, arubiochavez, phillip.thomas, jkusa_segment, rollcode, meg1000, nainy.agrawal, seg-rustybailey, jbandi-twilio, saisagarkappaganthula, forgetfulfellow, pooja.patil, joe.ayoub.segment, hmohanram_seg, brian.aguirre, enyi.asonye, farhan0581, tbrennanj, parag.panda, harsh.vardhan, sshaikh_segment, xinghao.huang, shupadhyay, john.lee1100, kx-segment, segment_fan, dazu70, sai-patanjali, emilyjia, y.yu, ea_segment, yli119, pooyaj, bharath.boregowda, igracheva-twilio, benattwilio, marinhero, dobrin.ganev, alfrimpong, dharpatel, alecjacobs-segment, cjo2, yashnit-segment, dltnbrks-segment, achandrashekaran, himanshuph, pragupta, tw-dgarcia, alayvora, aparna.singhal, ynguyen, timmyzsearcy, lweimersegment, anton-vylushchak, azhaotwilio, rokatyal, kjoerres, msaraf, vikakumar, aditi.raveesh, chenchensegmentcom, sanket.mishra, odoren_segment, jxin_twilio, rcheedhalla, jbasiglio-segment, viveksainaneesegment, priyanshis, abhinav.mehta, preetyp, akash.gautam07, nanotimm, yshkpr, srivig21, ssuneja, bala.singareddy, moyara2, arjunbhandage, akodankiry, rodhilton_twilio, cdelaomartinez, gbatra, spencerattick, segmentsean, sundareswar.jayakumar, hrishi-segment, kalyannistala, vaibhavnanda, bannapple, srishti-nema, gsolis_segment, itsarijitray, nirai-6, bhavanki-segment, hhwsegment, andrew.hall, kspachino, jcohentwilio2, dsolow, nanette.ranes, amigandhi, guthriesegment, miguelpdiaz8, mansari, kathlynn, chris.chan, mhodarkar-segment, sandhya16, hema-bahirwani-segment, bnakkina, praveenugiri, ighorela, nemery-segment, wlumsegment, nat-grid, needcaffeine, kbhargavaram-sg, irfan.ali.segment, ed-twilion-npm, aubreysine, sethgrid_segment, jibrang, seg-leonelsanches, smccoy-twilio, devthale, andwivedi, aditya_segment, poojapatilseg, gaprabhu, monusegment, jkilpatrick-segment, dasanchez, nsolanki-star, atitshah.seg, fjahangir, wongwilliam, ankit.gupta.unthinkable, shazan77, darcimm, jesswatson, afgan-segment, twiliochirag, grsmith, harsh-joshi99, anvesh_reddy_1311, aleman842, abueide-segment, caseyk09, ankigupta92, psandquist, jagsingh, dcp-twilio, sprajapati89, agerbas-segment, amitsinglaatseg, joy-twilio, amanda.ma, jinesh-twilio, ardev_npm, nikumar-segment-new, sarthak-twilio, nupur-twilio, vkundnani, prathoresegment, mmilhanseg, shubhkrishna, kvivekabhiram, ajsinghseg, kkolhe-twilio, prassingh, seg-ajasingh, mdkhan-tw, mahit, mfkimbell, l0aded, jay-savla, laksh25, sbommarito-segment, csmonlai, bha_segment, ayagrawal7, maygupta |

## Links

- npm: https://www.npmjs.com/package/@segment/analytics-node
- Repository: https://github.com/segmentio/analytics-next
- Homepage: https://github.com/segmentio/analytics-next#readme
- Issues: https://github.com/segmentio/analytics-next/issues
- npm.io page: https://npm.io/package/@segment/analytics-node

## Dependencies (6)

- [jose](https://npm.io/package/jose.md) ^5.1.0
- [tslib](https://npm.io/package/tslib.md) ^2.4.1
- [buffer](https://npm.io/package/buffer.md) ^6.0.3
- [@lukeed/uuid](https://npm.io/package/@lukeed/uuid.md) ^2.0.0
- [@segment/analytics-core](https://npm.io/package/@segment/analytics-core.md) 1.8.3
- [@segment/analytics-generic-utils](https://npm.io/package/@segment/analytics-generic-utils.md) 1.2.0

## Recent versions

- 3.1.0 (latest) — 2026-04-29
- 0.0.1-rc.3 (old) — 2023-02-23
- 3.0.0 — 2026-03-04
- 2.3.0 — 2025-07-09
- 2.2.1 — 2025-01-13
- 2.2.0 — 2024-09-25
- 2.1.3 — 2024-09-18
- 2.1.2 — 2024-04-29
- 2.1.1 — 2024-04-24
- 2.1.0 — 2024-03-06
- 2.0.0 — 2024-01-29
- 1.3.0 — 2024-01-10
- 1.2.0 — 2024-01-08
- 1.1.4 — 2023-11-29
- 1.1.3 — 2023-10-24
- … 32 more at https://npm.io/package/@segment/analytics-node/versions

## README

# @segment/analytics-node

https://www.npmjs.com/package/@segment/analytics-node

### OFFICIAL DOCUMENTATION (FULL)
- https://segment.com/docs/connections/sources/catalog/libraries/server/node

### LEGACY NODE SDK MIGRATION GUIDE:
- https://segment.com/docs/connections/sources/catalog/libraries/server/node/migration


## Runtime Support
- Node.js >= 20
- AWS Lambda
- Cloudflare Workers
- Vercel Edge Functions
- Web Workers / Browser (no device mode destination support)

## Quick Start
### Install library
```bash
# npm
npm install @segment/analytics-node
# yarn
yarn add @segment/analytics-node
# pnpm
pnpm install @segment/analytics-node
```

### Usage
Assuming some express-like web framework.
```ts
import { Analytics } from '@segment/analytics-node'
// or, if you use require:
const { Analytics } = require('@segment/analytics-node')

// instantiation
const analytics = new Analytics({ writeKey: '<MY_WRITE_KEY>' })

app.post('/login', (req, res) => {
   analytics.identify({
      userId: req.body.userId,
      previousId: req.body.previousId
  })
  res.sendStatus(200)
})

app.post('/cart', (req, res) => {
  analytics.track({
    userId: req.body.userId,
    event: 'Add to cart',
    properties: { productId: '123456' }
  })
   res.sendStatus(201)
});
```
See our [official documentation](https://segment.com/docs/connections/sources/catalog/libraries/server/node) for more examples and information.


## Settings & Configuration
See the documentation: https://segment.com/docs/connections/sources/catalog/libraries/server/node/#configuration

You can also see the complete list of settings in the [AnalyticsSettings interface](src/app/settings.ts).

---
_Source: https://npm.io/package/@segment/analytics-node · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._