Journeys - SegmentFlow.ai

Use journeys.trigger when your backend needs to start one active API-entry Journey for one Profile. Every trigger request requires an Idempotency-Key. Use journeyRuns.retrieve to poll the returned run handle.

import Segmentflow from "@segmentflow/segmentflow-typescript";

const client = new Segmentflow({ apiKey: process.env.SEGMENTFLOW_API_KEY });

const run = await client.v1.journeys.trigger(
  "receipt-flow",
  {
    profile: {
      email: "buyer@example.com",
      externalId: "customer-123",
    },
    variables: {
      orderId: "ord_123",
    },
  },
  { idempotencyKey: "receipt:ord_123" },
);

const status = await client.v1.journeyRuns.retrieve(run.runId);