---
title: "Trigger an outbound touch for an externally-orchestrated campaign"
method: POST
path: "/v1/conversation/campaign/touch"
tags: ["Conversation"]
---

# Trigger an outbound touch for an externally-orchestrated campaign

`POST /v1/conversation/campaign/touch`

Sends one outbound touch (voice or WhatsApp) under an EXTERNAL campaign and returns the conversationId to mirror the conversation off. Lorikeet runs no timers or sequencing: subscribe to the outcome webhooks to drive the next touch. Consent and do-not-contact are re-checked on every touch.

## Request body

- TriggerCampaignTouchRequestDTO
  - `campaignId` string, required — The ID of the externally-orchestrated campaign to trigger the touch under.
  - `customer` CampaignTouchCustomerDTO, required
    - `phoneNumber` string, required — The phone number to contact, in E.164 format.
    - `email` string — Email of the customer. Used to match an existing customer alongside the phone number.
    - `firstName` string — First name of the customer, used when creating a new record.
  - `workflowId` string — The ID of the workflow (talk track) to run for this touch. Resolved to the active version. Provide at most one of workflowId or agentId.
  - `agentId` string — The ID of the agent (talk track) to run for this touch. Provide at most one of workflowId or agentId.
  - `initialMessage` string — The opening message for WhatsApp touches. If omitted, provide a workflowId or contentSid.
  - `contentSid` string — WhatsApp only: the pre-approved template (content SID) to open a conversation cold, outside the customer-service window.
  - `contentVariables` object — WhatsApp only: variables to fill into the template.
  - `variables` object — Variables passed to the workflow or agent at runtime. Values may be typed (string, number, boolean, object, array).

## Response `200`

- TriggerCampaignTouchResponseDTO
  - `conversationId` string, required — The ID of the conversation that was created. Mirror the conversation off this ID.

## Changes

- **2026-07-02** `e4682d42ba49` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/optechai/apis/lorikeet-api/changes/v1/conversation/campaign/touch/post.md)

---

[API](https://skmtc.dev/optechai/apis/lorikeet-api.md) · [All operations](https://skmtc.dev/optechai/apis/lorikeet-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/optechai/lorikeet-api/revisions/789c7fa93584/schema)