Skip to main content
POST
Create Email AI Agent

Authorizations

Authorization
string
required
Enter your ContactSwing JWT Bearer token.

Request Body

name
string
required
Assistant display name. Example: "My Email Agent"
type
string
required
Assistant type: "EMAIL"
model
string
required
LLM model: "cw-llm-1"
instructions
string
required
Detailed recruiter instructions and candidate profiles
prompts
object
Agent prompts with agent and goal
agent
string
goal
string
kb_id
string
Knowledge base ID

Email-Specific Settings

gen_ai_response
string
Response mode: "SEMI_TOUCH"
email_setup
string
Email role: "Responder"
labels
string
Email labels/categories
action_ids
string[]
Linked action IDs []

Response

201 Created - Email assistant created successfully
ctx_id
string
Request context ID
data
object
assistant_id
string
New assistant ID
name
string
Assistant name
400 Bad Request - Invalid email configuration 401 Unauthorized - Invalid token