/crm-management

name: crm-management
description: Manage a CRM (Contact Relationship Management) system for your X followers and contacts. Tag, segment, search, and sync follower data. Use when users want to manage relationships with their X audience at scale.
license: Apache-2.0
metadata:
  author: nichxbt
  version: "1.0"

CRM Management

API-powered CRM system for managing relationships with your X followers and contacts.

Entry Points

| Goal | Route | Method | |------|-------|--------| | List CRM contacts | `GET /api/crm/contacts` | REST API | | Sync followers to CRM | `POST /api/crm/sync` | REST API | | Tag a contact | `POST /api/crm/contacts/:id/tag` | REST API | | Search contacts | `GET /api/crm/contacts?q=query` | REST API | | Segment contacts | `GET /api/crm/segments` | REST API | | Export contacts | `GET /api/crm/export` | REST API |

API Usage

Sync followers to CRM

POST /api/crm/sync
Authorization: Bearer <token>

Pulls your current followers from X and upserts them into the CRM database.

Tag a contact

POST /api/crm/contacts/:id/tag
Authorization: Bearer <token>
Content-Type: application/json

{ "tag": "vip" }

Search contacts

GET /api/crm/contacts?q=nichxbt&tag=vip&minFollowers=1000
Authorization: Bearer <token>

Segment contacts

GET /api/crm/segments?criteria=engagement&threshold=high
Authorization: Bearer <token>

Use Cases

| Goal | Approach | |------|----------| | Find your most engaged followers | `GET /api/crm/segments?criteria=engagement` | | Tag VIP followers for special treatment | `POST /api/crm/contacts/:id/tag` with `{ "tag": "vip" }` | | Export follower list to CSV/JSON | `GET /api/crm/export?format=csv` | | Find followers above a follower threshold | `GET /api/crm/contacts?minFollowers=5000` |

Notes

• CRM data is stored in PostgreSQL via Prisma (`User`, `FollowerSnapshot` models)
• Sync is incremental — only changed followers are updated
• Tags and segments are stored per-user in the database
• Requires authenticated API session (JWT or session cookie)

Related Skills

• **follower-monitoring** — Track follower changes over time
• **lead-generation** — Qualify followers as B2B leads
• **analytics-insights** — Analyze engagement patterns
• **growth-automation** — Grow followers to add to CRM