Leeeds developer docs

How to send leads to Leeeds: the embed script, the WordPress plugin, and the HTTP API for server-side capture and lead retrieval.

Every integration posts to a site (a hostname) that Bruce & Eddy has registered in the Leeeds dashboard. Unregistered hostnames get 404. Base URL: https://leeeds.dev.

Embed script

Add data-leeeds to any form and load the script. Leeeds captures name, email, phone, and message, plus every other named field as an extra field labeled from its <label>. A form without an action is submitted inline and shows its result in a [data-leeeds-status] element marked data-leeeds-state="success" or "error".

<form data-leeeds>
  <input type="text" name="name" required>
  <input type="email" name="email" required>
  <input type="tel" name="phone">
  <textarea name="message"></textarea>
  <button type="submit">Send</button>
</form>
<script src="https://leeeds.dev/embed.js"></script>

WordPress plugin

The Leeeds WordPress plugin adds a [leeeds_form] shortcode and a Gutenberg block, with settings under Settings → Leeeds. Version 1.1.0 and later support Turnstile.

Server-side capture

Post JSON to POST /api/leads with the client API token as a bearer token. Tokens start with lds_, are shown once in the dashboard, and must stay on your server.

curl -X POST "https://leeeds.dev/api/leads" \
  -H "Authorization: Bearer lds_your_token" \
  -H "Content-Type: application/json" \
  -d '{"domain":"yourdomain.com","name":"Jane Doe","email":"jane@example.com","message":"Hello","fields":[{"name":"budget","label":"Budget","value":"10k"}]}'

201 stored.
401 missing, malformed, or revoked token.
403 the domain belongs to a different client.
404 the domain is not registered.
429 rate limited: 10 submissions per minute per domain.

Retrieve leads

GET /api/leads with the same bearer token returns the 100 most recent leads for the client that owns it, as {"leads": [...]} with id, name, email, phone, message, domain, status, and created_at (Unix seconds).

Limits

Name 200 characters, email 320, phone 50, message 5,000, page URL 2,000. At most one auto-reply per email address per site per 24 hours.