Codapult
PricingPluginsDocs
Codapult

The SaaS Boilerplate for Builders

Product

  • Pricing
  • Plugins
  • Documentation

Company

  • Contact
  • GitHub

Legal

  • Privacy Policy
  • Terms of Service

© 2026 Codapult. All rights reserved.

All articles

Getting Started

  • Introduction
  • Quick Start
  • Project Structure

Configuration

  • Environment Variables
  • App Configuration

Authentication

  • Authentication
  • OAuth Providers
  • Two-Factor & Passwordless
  • Enterprise SSO (SAML)

Database

  • Database
  • Migrations

Teams

  • Teams & Organizations
  • Permissions & RBAC

Payments

  • Payments & Billing
  • Stripe Setup
  • LemonSqueezy Setup
  • Polar Setup
  • Payment Webhooks

Api

  • API Layer
  • tRPC
  • GraphQL

Ai

  • AI Features

Email

  • Email
  • Email Templates

Infrastructure

  • Infrastructure
  • File Storage
  • Background Jobs

Ui

  • UI & Theming

I18n

  • Internationalization

Content Management

  • Content Management

Admin

  • Admin Panel

Security

  • Security

Monitoring

  • Analytics & Monitoring

Modules

  • Module Architecture

Plugins

  • Plugin System
  • AI Kit Plugin
  • CRM Plugin
  • Helpdesk Plugin
  • Email Marketing Plugin

Deployment

  • Deployment
  • Troubleshooting

Upgrading

  • Upgrading Codapult

Developer Tools

  • MCP Server
  • Testing
Plugins

CRM Plugin

Companies, contacts, visual deal pipeline, activity timeline, custom fields, tags, AI lead scoring and deal prediction.

Overview

The CRM plugin adds a lightweight, embedded sales pipeline to your Codapult project. Your users get company and contact management, a visual Kanban deal pipeline, activity tracking, custom fields, and AI-powered lead scoring and deal prediction — all within the dashboard, no external tool needed.

Package: @codapult/plugin-crm · Price: $49 (one-time)

Install with:

npx @codapult/cli plugins add @codapult/plugin-crm

Features

Companies & Contacts

Full contact management with organizational hierarchy:

  • Company profiles — name, domain, industry, size, website, notes
  • Contact profiles — name, email, phone, job title, linked company
  • Custom fields — add text, number, date, or select fields per entity type (company, contact, deal)
  • Tags — flexible tagging system across companies, contacts, and deals
  • Lead score — AI-assigned 0–100 score stored on each contact, updated automatically or on demand

Visual Deal Pipeline

Kanban-style board for managing sales opportunities:

  • Configurable stages — create custom stages with names, colors, and win probability percentages
  • Drag-and-drop — move deals between stages visually
  • Multiple pipelines — create separate pipelines per team or product line; designate one as default
  • Stage reordering — drag stages to change the pipeline flow
  • Deal lifecycle — track deals as open, won, or lost; reopen closed deals
  • SLA dates — expected close date and actual close date tracking
  • Value tracking — deal amount and currency per deal

Activity Timeline

Complete interaction history for every entity:

  • Activity types — notes, calls, emails, meetings, and tasks
  • Linked entities — associate activities with a deal, contact, or company
  • Due dates — set deadlines for tasks and follow-ups
  • Completion tracking — mark activities as complete; filter upcoming and overdue items
  • AI summaries — generate an AI roll-up of recent activities per entity

AI Capabilities

Three AI-powered features built on the Vercel AI SDK:

  • Lead scoring — analyzes contact activity, engagement patterns, and deal history to assign a 0–100 score with factor breakdown
  • Deal win prediction — predicts deal outcome likelihood based on historical data, pipeline position, and activity patterns
  • Activity summarization — generates concise summaries of recent interactions for a contact, company, or deal

Analytics Dashboard

Built-in reporting on pipeline performance:

  • Pipeline overview — total deals, total value, win rate
  • Stage breakdown — deals and value per stage
  • Activity metrics — activity counts by type and time period
  • Conversion rates — stage-to-stage conversion tracking

Dashboard Pages

The plugin adds 6 pages to the dashboard under /dashboard/crm/:

PagePathDescription
People (Contacts)/dashboard/crm/contactsContact list with search and filters
Companies/dashboard/crm/companiesCompany directory
Deals/dashboard/crm/dealsKanban board view of deal pipeline
Deal Detail/dashboard/crm/deals/[id]Single deal with activities and AI tools
Pipelines/dashboard/crm/pipelinesPipeline and stage configuration
Analytics/dashboard/crm/analyticsPipeline performance dashboard

API Routes

All routes are served under /api/plugins/crm/. The plugin registers 47 API routes including:

  • GET|POST|PUT|DELETE /companies — company CRUD
  • GET|POST|PUT|DELETE /people — contact CRUD
  • GET|POST|PUT|DELETE /deals + POST /deals/move|won|lost|reopen + GET /deals/by-stage — deal lifecycle
  • GET|POST|PUT|DELETE /activities + POST /activities/complete + GET /activities/upcoming|overdue — activity management
  • GET|POST|PUT|DELETE /pipelines + POST /pipelines/stages/reorder + PUT /pipelines/default — pipeline configuration
  • GET|POST|DELETE /tags — tagging system
  • GET /analytics/overview|stages|activities — reporting
  • POST /ai/lead-score + POST /ai/deal-predict + POST /ai/summarize — AI features

Database Tables

The plugin creates 9 tables prefixed with crm_:

TablePurpose
crm_companyCompanies: name, domain, industry, size, website, notes
crm_personContacts: name, email, phone, job title, lead score
crm_pipelinePer-org pipelines with default flag
crm_stagePipeline stages: name, order, win probability
crm_dealDeals: value, currency, status, stage, owner, close dates
crm_activityActivities: type, content, due date, completion timestamp
crm_tagTags per entity (composite PK: entity type + id + tag)
crm_custom_fieldField definitions per entity type (text/number/date/select)
crm_custom_field_valueStored values per field per entity

Environment Variables

VariableDefaultDescription
CRM_AI_MODEL"gpt-4o-mini"Model for lead scoring, deal prediction, and summarization
CRM_DEFAULT_CURRENCY"USD"Default currency for new deals
CRM_DEFAULT_PIPELINE"default"Identifier for the default pipeline

Integration with Core Modules

ModuleHow CRM Uses It
Vercel AI SDK (ai)Lead scoring, deal prediction, activity summarization
logActivity()Audit trail for CRM operations
checkOrgQuota()Enforce crmContacts and crmDeals resource limits
onUserDeletedClears ownerId on deals when a user is removed
Database (Drizzle)All data storage
AI Kit PluginHelpdesk Plugin