AgentsCreate agent

Create agent

Creates a new AI agent. Costs 10 credits per agent and includes initial website training when companyUrl or companyInfo.domain is provided. The first agent created becomes the default agent automatically.

Calendar booking settings and selected page controls are not public API fields. Add booking links or other scheduling context to persona.customInstructions; website page discovery is automatic.

curl -X POST "https://api.sendkit.ai/v1/agents" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{
  "name": "Sales Agent"
}'
{
  "success": true,
  "data": {
    "_id": "664a1b2c3d4e5f6a7b8c9d10",
    "name": "Enterprise Sales Agent",
    "userId": "user_123",
    "workspaceId": "ws_123",
    "companyInfo": {
      "name": "Acme Inc",
      "description": "B2B SaaS platform for sales automation"
    },
    "persona": {
      "tone": "professional",
      "role": "senior account executive",
      "communicationStyle": "concise",
      "customInstructions": "Always mention our free trial. Focus on ROI and time savings."
    },
    "isDefault": false,
    "isActive": true,
    "createdAt": "2024-06-05T10:00:00.000Z",
    "updatedAt": "2024-06-05T10:00:00.000Z"
  }
}
POST
/v1/agents
POST
Base URLstring

Target server for requests. Edit to use your own host.

API Key (header: X-Api-Key)
X-Api-Keystring
Required

Platform API key (sk_user_...) or Workspace API key (sk_...)

Platform API key (sk_user_...) or Workspace API key (sk_...)
Content-Typestring
Required

The media type of the request body

Options: application/json
namestring
Required

Agent name (required, trimmed)

Min length: 1
companyInfoobject

Company context for the agent

companyUrlstring

Company website URL or domain used for automatic website training

personaobject

Agent personality configuration

isDefaultboolean

Set the new agent as the workspace default

Request Preview
Response

Response will appear here after sending the request

Authentication

header
X-Api-Keystring
Required

API Key for authentication. Platform API key (sk_user_...) or Workspace API key (sk_...)

Body

application/json
namestring
Required

Agent name (required, trimmed)

companyInfoobject

Company context for the agent

companyUrlstring

Company website URL or domain used for automatic website training

personaobject

Agent personality configuration

autonomousModeobject
followupSettingsobject
isDefaultboolean

Set the new agent as the workspace default

Responses