---
title: "Invoke a journey"
method: POST
path: "/journeys/{templateId}/invoke"
tags: ["Journeys"]
---

# Invoke a journey

`POST /journeys/{templateId}/invoke`

Invoke a journey by id or alias to start a new run. The response includes a `runId` identifying the run.

## Path parameters

- `templateId` string, required

## Request body

- JourneysInvokeRequest — Request body for invoking a journey. Requires either a user identifier or a profile with contact information. User identifiers can be provided via user_id field, or resolved from profile/data objects (user_id, userId, or anonymousId fields).
  - `user_id` string — A unique identifier for the user. If not provided, the system will attempt to resolve the user identifier from profile or data objects.
  - `profile` object — Profile data for the user. Can contain contact information (email, phone_number), user identifiers (user_id, userId, anonymousId), or any custom profile fields. Profile fields are merged with any existing stored profile for the user. Include context.tenant_id to load a tenant-scoped profile for multi-tenant scenarios.
  - `data` object — Data payload passed to the journey. The expected shape can be predefined using the schema builder in the journey editor. This data is available in journey steps for condition evaluation and template variable interpolation. Can also contain user identifiers (user_id, userId, anonymousId) if not provided elsewhere.

## Response `202`

Journey invocation accepted

- JourneysInvokeResponse
  - `runId` string, required — A unique identifier for the journey run that was created.

## Other responses

- `400` — Bad Request - validation error, invalid version, or missing recipient
- `404` — Journey not found
- `422` — Unprocessable Entity - trigger conditions failed, template archived or disabled

## Changes

- **2026-03-12** `19330fca8fa9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/trycourier/apis/courier/changes/journeys/:templateId/invoke/post.md)

---

[API](https://skmtc.dev/trycourier/apis/courier.md) · [All operations](https://skmtc.dev/trycourier/apis/courier/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trycourier/courier/revisions/6793811bc113/schema)