MarketSage API

Quick Start

1. Get Your API Key

1. Log in to MarketSage Dashboard
2. Navigate to Settings → API Keys
3. Click Generate New Key
4. Copy your API key (it won't be shown again)

2. Make Your First Request

curl https://api.marketsage.africa/v2/contacts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Core Resources

Contacts

GET    /v2/contacts          # List contacts
POST   /v2/contacts          # Create contact
GET    /v2/contacts/:id      # Get contact
PUT    /v2/contacts/:id      # Update contact
DELETE /v2/contacts/:id      # Delete contact

Campaigns

GET    /v2/campaigns              # List campaigns
POST   /v2/campaigns              # Create campaign
POST   /v2/campaigns/:id/send     # Send campaign
GET    /v2/campaigns/:id/analytics # Get analytics

Segments

GET    /v2/segments              # List segments
POST   /v2/segments              # Create segment
GET    /v2/segments/:id/contacts # Get contacts in segment

LeadPulse

POST   /v2/leadpulse/track       # Track event
GET    /v2/leadpulse/visitors    # Get visitors
GET    /v2/leadpulse/analytics   # Get analytics

Workflows

GET    /v2/workflows            # List workflows
POST   /v2/workflows            # Create workflow
POST   /v2/workflows/:id/trigger # Trigger workflow

Response Format

Success Response

{
  "success": true,
  "data": {
    "id": "contact_abc123",
    "email": "user@example.com",
    "created_at": "2025-01-15T10:30:00Z"
  }
}

Error Response

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid email address"
  }
}

Rate Limits

• Starter Plan: 10,000 requests/day
• Growth Plan: 50,000 requests/day
• Professional Plan: 100,000 requests/day
• Enterprise Plan: Custom limits

Next Steps