CRM API

Manage CRM contacts and pipeline

Overview

The CRM API lets you manage contacts, deals, and pipeline stages programmatically. All endpoints are scoped to your organization.

---

Contacts

List Contacts

GET /api/crm/contacts

Query Parameters

Parameter	Type	Description
search	string	Search by name or email
tag	string	Filter by tag
page	number	Page number (default: 1)
limit	number	Items per page (default: 25)

Response

{
  "contacts": [
    {
      "id": "contact_abc123",
      "name": "Jane Smith",
      "email": "[e-mail]",
      "company": "Acme Inc.",
      "tags": ["client", "enterprise"],
      "createdAt": "2025-02-10T08:00:00Z"
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 25
}

Create Contact

POST /api/crm/contacts

Request Body

{
  "name": "Jane Smith",
  "email": "[e-mail]",
  "company": "Acme Inc.",
  "phone": "[phone]",
  "tags": ["lead"],
  "notes": "Met at SaaStr conference"
}

Update Contact

PATCH /api/crm/contacts/{id}

Delete Contact

DELETE /api/crm/contacts/{id}

---

Pipeline

List Pipeline Stages

GET /api/crm/pipeline/stages

Move Contact to Stage

POST /api/crm/pipeline/move

Request Body

{
  "contactId": "contact_abc123",
  "stageId": "stage_qualified"
}

---

Tasks

List Tasks

GET /api/crm/tasks

Create Task

POST /api/crm/tasks

Request Body

{
  "title": "Follow up with Jane",
  "contactId": "contact_abc123",
  "dueDate": "2025-04-20T10:00:00Z",
  "assignedTo": "user_xyz"
}