---
title: "Create an agent"
method: POST
path: "/api/agents"
tags: ["Agents"]
---

# Create an agent

`POST /api/agents`

## Request

- Base URL: `https://api.agentbrink.com/api`
- URL: `https://api.agentbrink.com/api/api/agents`
- Auth: HTTP bearer

## Request body

- CreateAgentBody
  - `name` string, required
  - `organizationId` string, required
  - `systemPrompt` string
  - `mode` 'sdk' | 'managed'
  - `githubUsername` string

## Response `201`

Created

- Agent
  - `_id` string
  - `name` string
  - `organizationId` string
  - `systemPrompt` string
  - `mode` 'sdk' | 'managed'
  - `status` 'pending' | 'ready' | 'error'
  - `email` string, email
  - `phone` string
  - `enabledIntegrations` string[]
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `400`: Invalid request body

---

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