---
title: "Create Agent"
method: POST
path: "/agent"
---

# Create Agent

`POST /agent`

Create a new agent for your organization.

## Request body

- object
  - `name` string, required — Agent name
  - `jsonContent` object, required — Agent instructions as a structured document
  - `mcpServers` string[] — MCP servers available to the agent
  - `agent` string — Agent harness or model to use
  - `triggers` object[] — Event triggers to attach to the agent
    - `name` string, required — Trigger name
    - `integrationId` string — Integration ID for the trigger
    - `filters` object — Trigger-specific filters
  - `schedules` object[] — Schedules to attach to the agent
    - `cron` string, required — Cron expression for the schedule

## Response `200`

Agent created successfully

- object
  - `id` string, uuid, required — Unique identifier for the agent
  - `name` string, required — Agent name
  - `key` string, nullable — Macro key generated for the agent
  - `jsonContent` object, nullable — Agent instructions as a structured document
  - `agent` string, nullable — Agent harness or model to use
  - `mcpServers` string[] — MCP servers available to the agent
  - `organizationId` string, uuid, required
  - `enabledAt` string, date-time, nullable
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400` — Bad request - invalid input

---

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