Documentation

    Linillo Developer Docs

    Everything you need to integrate Linillo's referral platform into your hiring workflow.

    Quick Start

    Get up and running in 5 minutes

    API Reference

    Complete REST API documentation

    Webhooks

    Real-time event notifications

    Embed Widget

    Add referrals to your career page

    Video Tutorial: Complete API Setup

    Follow along with our step-by-step video walkthrough (10 minutes total)

    10:30 min

    API Integration Setup Guide

    Click to watch the full tutorial

    Progress5 chapters

    Video Chapters

    1
    Generate Your API Key
    1:30

    Learn how to create and manage your integration API keys from the dashboard.

    Navigate to Integrations
    Create new API key
    Copy and store securely
    2
    Configure Webhook URL
    2:00

    Set up your endpoint to receive real-time referral notifications.

    Enter webhook URL
    Generate webhook secret
    Test connectivity
    3
    Submit Your First Referral
    2:30

    Walk through making your first API call to submit a referral.

    API authentication
    Request structure
    Handle response
    4
    Handle Webhook Events
    3:00

    Process incoming webhook notifications and update your ATS.

    Verify signatures
    Parse event types
    Update candidate status
    5
    Test & Go Live
    1:30

    Validate your integration and switch from sandbox to production.

    Use test endpoint
    Verify webhook delivery
    Switch to live key

    Prefer reading? Jump to written guides:

    1. Get Your API Key

    First, generate an integration key from your company dashboard. Navigate to Integrations → API Keys and create a new key.

    Your API key will look like this:

    lin_live_abc123xyz789...

    2. Configure Your Integration

    Set up your webhook URL to receive real-time notifications when referrals are submitted or their status changes.

    // Example webhook payload
{
  "event": "referral.submitted",
  "data": {
    "referral_id": "ref_abc123",
    "job_id": "job_xyz789",
    "candidate": {
      "name": "John Doe",
      "email": "john@example.com"
    },
    "referrer": {
      "type": "recruiter",
      "name": "Jane Smith"
    }
  },
  "timestamp": "2025-01-15T10:30:00Z"
}

    3. Test Your Integration

    Use our sandbox environment to test your integration before going live.

    curl -X POST https://api.linillo.com/v1/test-webhook \
  -H "Authorization: Bearer lin_test_your_key" \
  -H "Content-Type: application/json"