Documentation

Getting Started

Learn how to deploy and use AgentNodus AI agents in minutes.

1. Create an Account

Sign up for free and access the dashboard.

  • Free 5-day trial included
  • No credit card required
  • Use your own AI provider API keys
Create Account →

2. Deploy an Agent

Choose from Email Assistant or Customer Support Copilot.

Available Agents:

  • Email Assistant - Manage and respond to emails with AI
  • Customer Support Copilot - AI-powered ticket handling with knowledge base

3. Add Your API Key

Use your own OpenAI, Anthropic, Google, or Groq API key.

Supported Providers:

AI OpenAI (GPT-4)
A Anthropic (Claude)
G Google (Gemini)
Q Groq (LPU)

API keys are encrypted and stored securely. You pay directly to your AI provider.

4. Start Using

Use natural language to interact with your AI agent.

Example Commands:

  • "Summarize my unread emails"
  • "Draft a response to the support ticket"
  • "Find similar tickets in our history"

Your agents use AI to understand context and provide intelligent responses.

Frequently Asked Questions

Is my data secure?

Yes! We use OAuth 2.0 for authentication and never store your email passwords. All API keys are encrypted.

Do I need to pay for AI?

You use your own API keys. We don't charge for AI usage - you pay directly to OpenAI, Google, etc.

How many emails can I process?

There's no limit from AgentNodus. Limits depend on your email provider and AI API quotas.

Support API Reference

Integrate support tickets into your application

Authentication

All API requests require a Bearer token. Generate your API key in Profile → API & Integrations. 

Authorization: Bearer YOUR_API_KEY

Base URL

https://agentnodus.com/api

Endpoints

GET /support/tickets

Retrieve all support tickets for your account.

Show example 
curl -X GET "https://agentnodus.com/api/support/tickets" \
  -H "Authorization: Bearer YOUR_API_KEY"
POST /support/tickets

Create a new support ticket.

Request Body

Field Type Required Description
subject string Yes Ticket subject
body string Yes Ticket message content
from_email string Yes Customer email address
from_name string No Customer name
priority string No low, normal, high, urgent
Show example 
curl -X POST "https://agentnodus.com/api/support/tickets" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Help with my order",
    "body": "I need help tracking my package #12345",
    "from_email": "[email protected]",
    "from_name": "John Doe",
    "priority": "high"
  }'
GET /support/tickets/{id}

Get details of a specific ticket including all messages.

POST /support/tickets/{id}/draft

Generate an AI-powered draft response for a ticket using your knowledge base.

Show example 
curl -X POST "https://agentnodus.com/api/support/tickets/123/draft" \
  -H "Authorization: Bearer YOUR_API_KEY"
POST /support/drafts/{id}/approve

Approve and send a draft response to the customer.

GET /support/knowledge/search?q={query}

Search your knowledge base for relevant articles.

GET /support/metrics

Get support analytics: ticket counts, resolution rates, SLA compliance.

Widget Integration

Add a chat widget to your website so customers can submit support tickets directly. 

<script src="https://agentnodus.com/widget.js"
        data-agent-id="YOUR_AGENT_ID"
        data-api-key="YOUR_API_KEY">
</script>

Find your Agent ID and API key in your Agent → Integration tab.

Response Format

All responses are JSON. Successful requests return status 200/201.

{
  "success": true,
  "data": {
    "id": 123,
    "subject": "Help with my order",
    "status": "open",
    "priority": "high",
    "created_at": "2026-01-15T12:00:00Z"
  }
}