CRM API

Base URL

All URLs referenced in the documentation have the following base:

https://api.meetandrock.com/v1/dev

Lead Management

Endpoints for managing leads and lead conversion

List Leads

Retrieve all leads

curl -X GET "https://api.meetandrock.com/v1/dev/crm/leads" \
  -H "Authorization: Bearer YOUR_API_KEY"

Create Lead

Create a new lead

curl -X POST "https://api.meetandrock.com/v1/dev/crm/leads" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "+1234567890",
    "source": "website",
    "status": "new"
  }'

Convert Lead

Convert a lead to a customer

curl -X POST "https://api.meetandrock.com/v1/dev/crm/leads/:leadId/convert" \
  -H "Authorization: Bearer YOUR_API_KEY"

Import Leads

Bulk import leads from CSV

curl -X POST "https://api.meetandrock.com/v1/dev/crm/leads/import" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/leads.csv"

Export Leads

Export leads to CSV

curl -X GET "https://api.meetandrock.com/v1/dev/crm/leads/export" \
  -H "Authorization: Bearer YOUR_API_KEY"

Customer Management

Endpoints for managing customers and their interactions

List Customers

Retrieve all customers

curl -X GET "https://api.meetandrock.com/v1/dev/crm/customers" \
  -H "Authorization: Bearer YOUR_API_KEY"

Customer Interactions

Get customer interactions history

curl -X GET "https://api.meetandrock.com/v1/dev/crm/customers/:customerId/interactions" \
  -H "Authorization: Bearer YOUR_API_KEY"

Add Interaction

Record a new customer interaction

curl -X POST "https://api.meetandrock.com/v1/dev/crm/customers/:customerId/interactions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "call",
    "notes": "Discussed new features",
    "outcome": "positive"
  }'

Customer Health

Get customer health metrics

curl -X GET "https://api.meetandrock.com/v1/dev/crm/customers/:customerId/health" \
  -H "Authorization: Bearer YOUR_API_KEY"

Feedback Management

Endpoints for managing customer feedback

Request Feedback

Send feedback request to customer

curl -X POST "https://api.meetandrock.com/v1/dev/crm/customers/:customerId/feedback/request" \
  -H "Authorization: Bearer YOUR_API_KEY"

Process Feedback

Process received feedback

curl -X POST "https://api.meetandrock.com/v1/dev/crm/feedback/:feedbackId" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "rating": 5,
    "comment": "Great service!",
    "category": "support"
  }'

Feedback Analytics

Get feedback analytics and insights

curl -X GET "https://api.meetandrock.com/v1/dev/crm/feedback/analytics" \
  -H "Authorization: Bearer YOUR_API_KEY"

Analytics & Reporting

Endpoints for CRM analytics and reporting

Lead Metrics

Get lead performance metrics

curl -X GET "https://api.meetandrock.com/v1/dev/crm/reports/leads" \
  -H "Authorization: Bearer YOUR_API_KEY"

Customer Metrics

Get customer performance metrics

curl -X GET "https://api.meetandrock.com/v1/dev/crm/reports/customers" \
  -H "Authorization: Bearer YOUR_API_KEY"

Dashboard Analytics

Get comprehensive CRM analytics

curl -X GET "https://api.meetandrock.com/v1/dev/crm/analytics/dashboard" \
  -H "Authorization: Bearer YOUR_API_KEY"

Error Responses

400 Bad Request
{
  "message": "Invalid request parameters"
}

401 Unauthorized
{
  "message": "Invalid or missing API key"
}

404 Not Found
{
  "message": "Resource not found"
}

409 Conflict
{
  "message": "Resource already exists"
}

Contents