nirholas 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,FollowerSnapshotmodels) - 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