---
title: "Invoke a journey"
method: POST
path: "/capture/{journey_id}"
---

# Invoke a journey

`POST /capture/{journey_id}`

## Request

- Base URL: `https://api.workflows.trengo.com`
- URL: `https://api.workflows.trengo.com/capture/{journey_id}`
- Auth: none required

## Path parameters

- `journey_id` string, required

## Request body

- object
  - `contact` object, required: The contact associated with the current journey, such as the recipient of messages sent during this journey.
    - `identifier` object: Unique identifier for the contact. You can identify the contact by ID, phone number, or email address. If you provide an ID, it must correspond to an existing contact. If a phone number or email is provided and no matching contact is found, a new contact will be created.
      - `type` 'ID' | 'PHONE' | 'EMAIL', required
      - `value` string, required: When identifying the contact by email, it must be a valid email address. When identifying the contact by phone number, it must be provided in E.164 format (e.g., +316123456789). When identifying the contact by ID, it must be an existing contact ID.
    - `attributes` object: If the identifier matches an existing contact, the attributes will be used to update that contact. If no match is found, the attributes will be used to create a new contact.
      - `name` string: The contact name
      - `phone` string: The contact phone number.
      - `email` string: The contact email address.
      - `groups` integer[]: The groups this contact is in
      - `custom_fields` object
        - `id` integer, required: The ID of the custom field
        - `value` string, required: The value of the custom field
  - `variables` object[]: An optional field to send custom data to your webhook, such as a status_url or order_id, with a maximum of 32 variables.
    - `key` string, required: The name of the variable. Max 75 characters.
    - `value` string, required: The value of the variable. Max 255 characters.

## Response `201`

201

- object
  - `status` integer
  - `message` string
  - `journey_id` string
  - `journey_run_id` string

## Other responses

- `404`: 404
- `422`: 422
- `500`: 500

---

[API](https://skmtc.dev/trengo/apis/journeys-api.md) - [All operations](https://skmtc.dev/trengo/apis/journeys-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trengo/apis/journeys-api/revisions/31501260dda4?raw)