Vendor Portal

The Vendor Portal allows lead vendors to submit leads, track performance, and manage their integration with Ledly.

Overview

As a vendor, you can:

• Submit leads via API or bulk upload
• Track submissions in real-time
• View acceptance rates and rejection reasons
• Monitor performance with detailed analytics
• Manage API keys and credentials

Getting Started

Step 1: Receive Your Credentials

Your organization administrator will:

1. Create your vendor account in Ledly
2. Provide you with portal access credentials
3. Generate your initial API key

Step 2: Access the Portal

1. Go to your organization’s vendor portal URL (provided by admin)
2. Log in with your credentials
3. Complete any required profile setup

Step 3: Generate API Key

1. Navigate to Settings → API Keys
2. Click Generate API Key
3. Copy and securely store your key
4. Configure your systems to use the key

Portal Features

Dashboard

The dashboard shows your key metrics at a glance:

Lead History

View all submitted leads with status:

Rejection Analytics

Understand why leads are being rejected:

• Invalid Email - Email format or domain issues
• Missing Required Field - Required field not provided
• Duplicate - Lead already exists in system
• Failed Validation - Custom validation rule failed
• Rate Limited - Too many submissions too quickly

API Integration

Endpoint

POST https://api.ledly.io/api/leads/inbound

Authentication

Include your API key in the header:

Authorization: Bearer your_vendor_api_key

Basic Request

curl -X POST https://api.ledly.io/api/leads/inbound \
  -H "Authorization: Bearer your_vendor_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "first_name": "Jane",
    "last_name": "Doe",
    "phone": "+1-555-123-4567",
    "program_interest": "MBA"
  }'

Response

Success:

{
  "success": true,
  "lead_id": "lead_xyz789",
  "message": "Lead accepted"
}

Rejection:

{
  "success": false,
  "error": "Validation failed",
  "details": [
    { "field": "email", "message": "Invalid email format" }
  ]
}

See Submitting Leads for complete API documentation.

Rate Limits

Vendors are subject to rate limits to ensure system stability:

When rate limited, you’ll receive:

{
  "success": false,
  "error": "Rate limit exceeded",
  "retry_after": 30
}

Best Practice: Implement exponential backoff when rate limited.

Billing (Pay-Per-Lead)

If you’re on a Pay-Per-Lead (PPL) arrangement:

Pricing Tiers

Pricing is configured by your organization and may include:

• Base price per lead - Standard rate for accepted leads
• Quality bonuses - Higher rates for high-quality leads
• Volume discounts - Lower rates at higher volumes
• Rejection credits - No charge for rejected leads

Viewing Your Bill

1. Go to Billing in the vendor portal
2. View current month charges
3. Download invoices for past months
4. See lead-by-lead billing breakdown

Monthly Summary

Month: December 2024
----------------------
Leads Submitted:    1,250
Leads Accepted:     1,100
Leads Rejected:       150
Acceptance Rate:    88.0%

Base Rate:          $5.00/lead
Volume Discount:    10%
Effective Rate:     $4.50/lead

Total Due:          $4,950.00

Field Requirements

Each organization may have different field requirements. Check with your administrator for:

Required Fields

Fields that must be provided for lead acceptance:

• email (always required)
• Organization-specific required fields

Optional Fields

Fields that are accepted but not required:

• first_name, last_name
• phone
• program_interest
• custom fields

Field Validation

Fields are validated according to organization rules:

• Email format and domain validation
• Phone number format
• Program code validation
• Custom validation rules

Support

For Vendors

• Email: [email protected]
• Check your portal for organization-specific support contacts

Common Issues

Security Requirements

As a vendor, you must:

1. Secure your API key - Never expose in client-side code or logs
2. Use HTTPS - All API calls must use HTTPS
3. Validate consent - Only submit leads with proper consent
4. Protect PII - Follow data protection regulations (GDPR, CCPA)
5. Report breaches - Immediately notify us of any security incidents