Quick Start

Follow this step-by-step guide to configure your outbound webhook dispatcher, send your first payload, and handle the returned lead ID.

3-Step Setup Overview

Obtain Your Partner Source Token

Your 3i client or account manager provides your dedicated x-source-token (UUID).

Where Agents Find This in 3i CRM:
The agent opens Data & Integrations → Lead Sources, clicks on their vendor source, and copies the token displayed under Gateway URL (per-vendor token).

Configure Your Webhook Dispatcher

Configure your server or webhook engine with the following destination parameters:

Endpoint URL: https://api.3i.life/functions/v1/inbound-lead-gateway
HTTP Method: POST
Headers:
- Content-Type: application/json
- x-source-token: <YOUR_ASSIGNED_TOKEN>
- Idempotency-Key: <UNIQUE_UUID_PER_DELIVERY>

Dispatch Your Payload & Store lead_id

Send your lead data. 3i processes the payload, creates or updates the record, and returns a JSON response containing our internal lead_id. Store this ID in your database to correlate future updates.

Already have an existing JSON payload format? You can send your existing field names without rewriting your dispatcher! 3i’s ingestion engine automatically detects aliases (e.g. cell → phone, coverage_requested → coverage_amount) and preserves all custom parameters in custom_fields with zero data loss.

Using No-Code Tools? (Zapier, Make, n8n, GoHighLevel)

Prefer visual setup over custom code? Follow our step-by-step guides for connecting Webhooks by Zapier, Make.com HTTP modules, n8n, or GoHighLevel workflows.

Code Examples

Select your programming language or tool below for a complete, production-ready dispatch script:

curl -X POST "https://api.3i.life/functions/v1/inbound-lead-gateway" \
  -H "Content-Type: application/json" \
  -H "x-source-token: YOUR_ASSIGNED_TOKEN" \
  -H "Idempotency-Key: lead_delivery_99201" \
  -d '{
    "first_name": "Marcus",
    "last_name": "Vance",
    "phone": "5125550188",
    "email": "m.vance@example.com",
    "address": "1204 Pecan Grove Rd",
    "city": "Austin",
    "state": "TX",
    "zipcode": "78704",
    "age": 63,
    "date_of_birth": "1963-04-12",
    "gender": "Male",
    "coverage_type": "Final Expense",
    "coverage_amount": "25000",
    "monthly_budget": "$85/mo",
    "smoker": false,
    "health_conditions": "Controlled blood pressure; takes Lisinopril",
    "notes": "Verified Army veteran looking for burial coverage. Prefers morning contact."
  }'

import axios, { AxiosError } from 'axios';

const GATEWAY_URL = 'https://api.3i.life/functions/v1/inbound-lead-gateway';
const SOURCE_TOKEN = 'YOUR_ASSIGNED_TOKEN';

interface LeadPayload {
  first_name: string;
  last_name: string;
  phone: string;
  email?: string;
  state?: string;
  coverage_type?: string;
  coverage_amount?: string;
  notes?: string;
  [key: string]: unknown;
}

async function deliverLead(lead: LeadPayload, deliveryId: string) {
  try {
    const response = await axios.post(GATEWAY_URL, lead, {
      headers: {
        'Content-Type': 'application/json',
        'x-source-token': SOURCE_TOKEN,
        'Idempotency-Key': deliveryId,
      },
      timeout: 10000,
    });

    // Successfully received by 3i CRM
    const { lead_id, status, message } = response.data;
    console.log(`Lead accepted [${status}]: 3i Lead ID = ${lead_id}`);

    // Store response.data.lead_id in your database
    return response.data;
  } catch (err) {
    const error = err as AxiosError<{ error?: string; error_code?: string }>;
    console.error('Delivery failed:', error.response?.data || error.message);
    throw error;
  }
}

import requests
import uuid

GATEWAY_URL = "https://api.3i.life/functions/v1/inbound-lead-gateway"
SOURCE_TOKEN = "YOUR_ASSIGNED_TOKEN"

payload = {
    "first_name": "Marcus",
    "last_name": "Vance",
    "phone": "5125550188",
    "email": "m.vance@example.com",
    "state": "TX",
    "coverage_type": "Final Expense",
    "coverage_amount": "25000",
    "monthly_budget": "$85/mo",
    "smoker": False,
    "notes": "Verified Army veteran looking for burial coverage."
}

headers = {
    "Content-Type": "application/json",
    "x-source-token": SOURCE_TOKEN,
    "Idempotency-Key": f"delivery_{uuid.uuid4()}"
}

try:
    response = requests.post(GATEWAY_URL, json=payload, headers=headers, timeout=10)
    response.raise_for_status()
    data = response.json()
    print(f"Lead accepted! 3i Lead ID: {data.get('lead_id')}")
except requests.exceptions.RequestException as e:
    print(f"Delivery failed: {e}")

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
	"time"
)

const gatewayURL = "https://api.3i.life/functions/v1/inbound-lead-gateway"
const sourceToken = "YOUR_ASSIGNED_TOKEN"

func main() {
	payload := map[string]interface{}{
		"first_name":      "Marcus",
		"last_name":       "Vance",
		"phone":           "5125550188",
		"email":           "m.vance@example.com",
		"state":           "TX",
		"coverage_type":   "Final Expense",
		"coverage_amount": "25000",
	}

	body, _ := json.Marshal(payload)
	req, _ := http.NewRequest("POST", gatewayURL, bytes.NewBuffer(body))
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("x-source-token", sourceToken)
	req.Header.Set("Idempotency-Key", fmt.Sprintf("lead_%d", time.Now().Unix()))

	client := &http.Client{Timeout: 10 * time.Second}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	fmt.Printf("HTTP Status: %s\n", resp.Status)
}

<?php

$gatewayUrl = 'https://api.3i.life/functions/v1/inbound-lead-gateway';
$sourceToken = 'YOUR_ASSIGNED_TOKEN';

$payload = [
    'first_name' => 'Marcus',
    'last_name' => 'Vance',
    'phone' => '5125550188',
    'email' => 'm.vance@example.com',
    'state' => 'TX',
    'coverage_type' => 'Final Expense',
    'coverage_amount' => '25000',
    'notes' => 'Looking for burial coverage.'
];

$ch = curl_init($gatewayUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'x-source-token: ' . $sourceToken,
    'Idempotency-Key: lead_' . uniqid()
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo "Response ({$httpCode}): {$response}\n";
?>

Response Verification

Every successful request returns HTTP 200 with the assigned lead_id:

{
  "success": true,
  "message": "Lead created successfully",
  "lead_id": "b3040da5-9bd1-4a4b-8fd3-40e94bb5083f",
  "agent_id": "5170d1fa-fa77-4c7b-b5d1-93c6838a6a12",
  "status": "New",
  "auto_sync_enabled": false
}

Best Practice: Save response.data.lead_id in your local database or CRM tracking table. When reviewing conversions, checking delivery receipts, or querying status, this UUID links the record directly across both platforms.

Get Started

Lead & Appointment Ingestion

Testing & Observability

Underwriting Engine

3-Step Setup Overview

Using No-Code Tools? (Zapier, Make, n8n, GoHighLevel)

Code Examples

Response Verification

​3-Step Setup Overview

Using No-Code Tools? (Zapier, Make, n8n, GoHighLevel)

​Code Examples

​Response Verification

3-Step Setup Overview

Code Examples

Response Verification