curl -X POST "https://api.affonso.io/v1/signups" \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "click_id": "ref_clk_xyz789",
    "email": "jane@example.com",
    "external_user_id": "user_42",
    "name": "Jane Doe"
  }'

const response = await fetch("https://api.affonso.io/v1/signups", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.AFFONSO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    click_id: clickId,
    email: "jane@example.com",
    external_user_id: user.id,
  }),
});
const { data } = await response.json();
console.log("Lead created:", data.id);

import os, requests

resp = requests.post(
    "https://api.affonso.io/v1/signups",
    headers={"Authorization": f"Bearer {os.environ['AFFONSO_API_KEY']}"},
    json={
        "click_id": click_id,
        "email": "jane@example.com",
        "external_user_id": str(user.id),
    },
)
resp.raise_for_status()
print("Lead created:", resp.json()["data"]["id"])

{
  "success": true,
  "data": {
    "id": "ref_clk_xyz789",
    "affiliate_id": "aff_abc123",
    "email": "jane@example.com",
    "customer_id": null,
    "subscription_id": null,
    "status": "lead",
    "name": "Jane Doe",
    "metadata": null,
    "created_at": "2026-01-25T11:55:00Z",
    "converted_at": null
  }
}

{
  "success": true,
  "data": {
    "id": "ref_clk_xyz789",
    "affiliate_id": "aff_abc123",
    "email": "jane@example.com",
    "status": "lead",
    "name": "Jane Doe",
    "created_at": "2026-01-25T11:55:00Z",
    "converted_at": null
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "At least one of email or external_user_id is required",
    "issues": {
      "email": ["At least one of email or external_user_id is required"]
    }
  }
}

{
  "success": false,
  "error": {
    "code": "CLICK_NOT_FOUND",
    "message": "Click not found or does not belong to your team"
  }
}