---
title: "Create Agent Trigger"
method: POST
path: "/api/agent-triggers"
tags: ["agent-triggers"]
---

# Create Agent Trigger

`POST /api/agent-triggers`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/agent-triggers`
- Auth: none declared

## Headers

- `x-impersonate-identity-id` string, nullable

## Request body

- CreateAgentTriggerRequest
  - `agent_identity_id` string, uuid, required
  - `target_chat_id` string, uuid, required
  - `instruction` string, required
  - `trigger_kind` 'time_once' | 'time_recurring', required
  - `run_at` string, date-time, nullable
  - `interval_minutes` integer, nullable
  - `cron_expr` string, nullable
  - `timezone` string
  - `action_type` 'chat'
  - `metadata` object, nullable
  - `context_mode` 'adaptive' | 'literal'

## Response `201`

Successful Response

- AgentTriggerResponse
  - `id` string, uuid, required
  - `owner_identity_id` string, uuid, required
  - `agent_identity_id` string, uuid, required
  - `target_chat_id` string, uuid, required
  - `trigger_kind` string, required
  - `status` string, required
  - `execution_mode` string, required
  - `instruction` string, required
  - `context_mode` 'adaptive' | 'literal', nullable, required
  - `timezone` string, required
  - `run_at` string, nullable, required
  - `interval_minutes` integer, nullable, required
  - `cron_expr` string, nullable, required
  - `next_run_at` string, nullable, required
  - `last_run_at` string, nullable, required
  - `last_run_status` string, nullable, required
  - `consecutive_failure_count` integer, required
  - `auto_paused_reason` string, nullable, required
  - `action_type` string, required
  - `email_to` string, nullable, required
  - `email_subject` string, nullable, required
  - `webhook_last_delivery_at` string, nullable, required
  - `webhook_signing_required` boolean, required
  - `metadata` object, required
  - `created_at` string, required
  - `updated_at` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thinqos/apis/thinqos-api.md) · [All operations](https://skmtc.dev/thinqos/apis/thinqos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thinqos/apis/thinqos-api/revisions/ce2c2ce318b1?raw)