API REFERENCE

Lead intake

Anonymous but token-gated per lead source. JSON or form-encoded; CORS open so browser forms can post directly.

https://melodocs.ai

POST/api/intake/{token}

Create a lead in the source the token belongs to. At least one of name, phone or email is required.

FIELDTYPEDESCRIPTION

namestringThe lead's name. Up to 120 characters.

phonestringUp to 40 characters.

emailstringUp to 160 characters.

addressstringUp to 240 characters.

notesstringUp to 2,000 characters. The field name message is accepted as an alias.

websitehoneypotLeave empty. Any value marks the request as a bot and it is silently dropped.

turnstileTokenstringOptional Cloudflare Turnstile token, verified when the bot check is enabled.

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",
       "notes":"Garage repaint, two coats"}'

200 OK

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

// 400 — bad token, unreadable body,
//       or no name/phone/email
// 404 — intake link deactivated