GETTING STARTED

Lead intake

One POST and a new lead is in your pipeline. Point your website form, Zapier, or anything that can send a webhook at your source's intake URL.

Every lead source you create gets its own intake token and hosted form. The token is a UUID that appears in the source's form URL — the same token works for direct POSTs. Grab it from your lead sources settings.

POST /api/intake/{token}

curl -X POST https://melodocs.ai/api/intake/YOUR_SOURCE_TOKEN \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Dana Whitfield",
    "phone": "(206) 555-0114",
    "email": "dana@example.com",
    "address": "8114 NE 145th St, Kenmore WA",
    "notes": "Garage repaint, two coats, prep included"
  }'

JSON and form-encoded bodies are both accepted, and CORS is open — a form embedded on your own website can post directly from the browser. At least one of name, phone or email is required; notes also accepts the field name message, so most form builders work unchanged.

Spam protection

—A honeypot: any value in a field named website makes the request a silent no-op that still returns ok.

—Optional bot check: when Turnstile is configured, pass the widget's token as turnstileToken.

Responses

200 OK

{ "ok": true, "id": "<lead-id>" }

—400 — malformed token, unreadable body, or no name/phone/email.

—404 — the intake link has been deactivated.

Updated August 6, 2026Did this page help?

NEXTMeloScan uploads