---
title: "Create agent endpoint"
method: POST
path: "/api/v1/novasynth/agent-endpoints"
tags: ["NovaSynth"]
---

# Create agent endpoint

`POST /api/v1/novasynth/agent-endpoints`

## Request

- Base URL: `https://dev.noveum.ai`
- URL: `https://dev.noveum.ai/api/v1/novasynth/agent-endpoints`
- Auth: API key in cookie `apiKeyCookie` and HTTP bearer

Associate the endpoint with a project via the `projectId` query parameter or the `projectId` field in the JSON body (query takes precedence).

## Query parameters

- `projectId` string

## Request body

- union
  - object
    - `type` string, required
    - `name` string, required
    - `description` string
    - `isInbound` boolean
    - `projectId` string
    - `livekitUrl` string, uri, required
    - `livekitApiKey` string, required
    - `livekitApiSecret` string, required
    - `livekitAgentName` string, required
  - object
    - `type` string, required
    - `name` string, required
    - `description` string
    - `isInbound` boolean
    - `projectId` string
    - `phoneNumber` string, required
    - `phoneCountryCode` string, required
  - object
    - `type` string, required
    - `name` string, required
    - `description` string
    - `isInbound` boolean
    - `projectId` string
    - `websocketUrl` string, uri, required
    - `websocketAuthHeader` string
  - object
    - `type` string, required
    - `name` string, required
    - `description` string
    - `isInbound` boolean
    - `projectId` string
    - `pipecatApiKey` string, required
    - `pipecatAgentName` string, required
    - `pipecatAgentConfigJson` object
    - `pipecatRoomPropertiesJson` object
  - object
    - `type` string, required
    - `name` string, required
    - `description` string
    - `isInbound` boolean
    - `projectId` string
    - `vapiApiKey` string, required
    - `vapiAssistantId` string
  - object
    - `type` string, required
    - `name` string, required
    - `description` string
    - `isInbound` boolean
    - `projectId` string
    - `retellApiKey` string, required
    - `retellAgentId` string
  - object
    - `type` string, required
    - `name` string, required
    - `description` string
    - `isInbound` boolean
    - `projectId` string
    - `elevenLabsApiKey` string, required
    - `elevenLabsAgentId` string
  - object
    - `type` string, required
    - `name` string, required
    - `description` string
    - `isInbound` boolean
    - `projectId` string
    - `url` string, uri, required
    - `authType` 'none' | 'bearer' | 'api_key' | 'basic' | 'custom_header'
    - `authSecret` string
    - `model` string
    - `method` 'POST' | 'GET'
    - `extraHeaders` object
    - `queryParams` object
    - `timeoutMs` integer
    - `maxRetries` integer
    - `validateStatusMode` '2xx' | '200' | 'any'
    - `streaming` boolean
    - `bodyTemplate` string
    - `responseTransform` string
    - `sessionMode` 'stateless' | 'session_id'
    - `sessionParser` string
    - `toolsPassthrough` boolean
    - `agentSpeaksFirst` boolean

## Response `200`

Success

- object

## Other responses

- `201`: Created
- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict
- `422`: Unprocessable entity
- `500`: Internal server error

---

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