Skip to main content
POST
/
v0
/
agents
Error
A valid request URL is required to generate request examples
{
  "id": "<string>",
  "llmProvider": "<string>",
  "model": "<string>",
  "instruction": "<string>",
  "channelProvider": "<string>",
  "isConnectedToChannel": true,
  "isActive": true,
  "address": "<string>",
  "name": "<string>",
  "createdBy": "<string>",
  "orgId": "<string>",
  "webhookUrl": "<string>",
  "webhookSecret": "<string>",
  "eventConfigs": [
    {
      "id": "<string>",
      "agentId": "<string>",
      "displayName": "<string>",
      "key": "<string>",
      "description": "<string>",
      "schema": {
        "name": "apppointment_request",
        "schema": {
          "type": "object",
          "properties": {
            "email": {
              "type": "string",
              "description": "The email address of the user."
            },
            "age": {
              "type": "number",
              "description": "The age of the user."
            }
          },
          "required": [
            "email"
          ],
          "additionalProperties": false
        },
        "strict": true
      },
      "waitForResponse": true,
      "stopConversation": true,
      "isActive": true,
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "isDeleted": true,
  "deletedAt": {}
}

Authorizations

​
Authorization
string
header
required

Example: Bearer <YOUR_API_KEY>

Body

application/json
​
channelProvider
enum<string>
required

The channel provider to connect to. Currently supported: GMAIL (for Google Workspace). Coming soon: OUTLOOK (for Microsoft 365).

Available options:
OUTLOOK,
GMAIL
Example:

"GMAIL"

​
address
string
required

The email address the agent will use to send and receive messages.

Example:

"[email protected]"

​
description
string

A description for the agent.

Example:

"Handles support emails for the team."

​
name
string

The display name for the agent.

Example:

"Janet Mendoza"

​
webhookUrl
string

The webhook URL to receive Events for this Agent.

Example:

"https://api.example.com/webhook"

​
webhookSecret
string

The secret that will be sent along with each Webhook as X-Monsteria-Webhook-Secret header.

Example:

"supersecret"

​
model
string

The LLM model to use for the agent. E.g., gpt-4, gpt-3.5-turbo, claude-2, etc.

Example:

"gpt-4.1"

​
instruction
string

Instructions and guidelines for the agent.

Example:

"You are a receptionist at a dental clinic. Your task is to assist patients in scheduling, rescheduling, or canceling appointments."

Response

​
id
string
required
​
llmProvider
string
required
​
model
string
required
​
instruction
string
required
​
channelProvider
string
required
​
isConnectedToChannel
boolean
required
​
isActive
boolean
required
​
address
string
required
​
name
string
required
​
createdBy
string
required
​
orgId
string
required
​
webhookUrl
string
required
​
webhookSecret
string
required
​
eventConfigs
object[]
required
​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
isDeleted
boolean
required
​
deletedAt
object
required