The Revnator API exposes the core CRM objects under /api/v1. All endpoints require the X-Revnator-API-Key header and return the standard { data, error } envelope. The base URL is https://app.revnator.com/api/v1.
Contacts
- GET /contacts — list contacts (limit, offset, search, status, list_id)
- POST /contacts — create a contact (name and email required)
- GET, PATCH, DELETE /contacts/{id} — read, update, or soft-delete one contact
- GET, POST /contacts/{id}/notes — list or add notes
- POST /contacts/{id}/tasks — create a task for a contact
- POST /contacts/{id}/sequences — enrol a contact into a sequence
Accounts and Deals
- GET, POST /accounts and GET, PATCH, DELETE /accounts/{id}
- GET, POST /deals and GET, PATCH, DELETE /deals/{id}
- POST /deals/{id}/stage — move a deal to a new stage (logs an activity)
Sequences and Tasks
- GET, POST /sequences and GET, PATCH, DELETE /sequences/{id}
- POST /sequences/{id}/enroll — bulk-enrol contacts; GET /sequences/{id}/contacts
- GET, POST /tasks and GET, PATCH, DELETE /tasks/{id}
- POST /tasks/{id}/complete — mark a task complete
Pipeline, Search, and Analytics
- GET /pipeline/stages — list pipeline stages
- GET /pipeline/deals — deal counts and totals per stage
- GET /search?q=...&types=contacts,deals,accounts,tasks — cross-object search
- GET /analytics?period=7d|30d|90d — rollups for contacts, deals, emails, and tasks
AI
- GET /ai/suggestions — pending AI suggestions
- POST /ai/suggestions/{id}/accept — accept a suggestion
- POST /ai/trigger — score one contact and persist its next best action (rate-limited)
Example request and response
Create a contact:
1curl -X POST https://app.revnator.com/api/v1/contacts \
2 -H "X-Revnator-API-Key: rvn_live_your_key_here" \
3 -H "Content-Type: application/json" \
4 -d '{ "name": "Jane Smith", "email": "jane@acme.com", "company": "Acme Corp" }'
1{
2 "data": {
3 "id": "…",
4 "name": "Jane Smith",
5 "email": "jane@acme.com",
6 "company": "Acme Corp",
7 "created_at": "2026-05-20T10:00:00Z"
8 },
9 "error": null
10}
The MCP server
For AI tools, Revnator publishes an MCP server (@revnator/mcp) that wraps these endpoints as 33 tools across nine groups. Install it and authenticate with the same rvn_live_ key so assistants like Claude Desktop and Cursor can work with your workspace directly. Copy the configuration from Settings → API.
