---
title: "Trigger a campaign"
method: POST
path: "/api/v1/campaigns/{campaign_id}:trigger"
tags: ["ClixExternalService"]
---

# Trigger a campaign

`POST /api/v1/campaigns/{campaign_id}:trigger`

## Request

- Base URL: `https://api.clix.so`
- URL: `https://api.clix.so/api/v1/campaigns/{campaign_id}:trigger`
- Auth: API key in header `X-Clix-Project-ID` and API key in header `X-Clix-API-Key`

Triggers an API-triggered campaign to send messages to a specific audience

## Path parameters

- `campaign_id` string, required

## Request body

- V1TriggerCampaignRequest: Request to trigger a campaign
  - `audience` object: Target audience for the campaign
    - `broadcast` boolean: If true, sends to all eligible users
    - `targets` object[]: Specific targets to send to
      - `project_user_id` string: Target user by project user ID
      - `device_id` string: Target specific device
  - `properties` object: Custom properties for personalization

## Response `200`

Campaign triggered successfully

- V1TriggerCampaignResponse: Response containing the trigger ID
  - `trigger_id` string: Unique identifier for this campaign trigger

## Other responses

- `400`: Bad request - invalid parameters or campaign not found

---

[API](https://skmtc.dev/clix/apis/clix-external-v1-clix-proto.md) - [All operations](https://skmtc.dev/clix/apis/clix-external-v1-clix-proto/llms.txt) - [OpenAPI document](https://skmtc.dev/clix/apis/clix-external-v1-clix-proto/revisions/b5048a49e843?raw)