Lead intake URLs

Point a form's webhook at an intake URL and every submission becomes a call task. No code, no Zapier.

Create an intake URL

In the dashboard, open Integrations and create an intake URL. Give it a name, the goal for the caller, optional notes that go into every brief, the consent basis, and a default state for forms that don't ask for one. You get a URL like:

https://ringahuman.com/api/intake/rah_in_…

The URL is the credential: it can only create call tasks for your account, and you can revoke it at any time. Use one URL per form so you can tell sources apart and revoke them independently.

Send leads to it

POST the submission as JSON or form data. We look for the phone number, name, company and state automatically, and put every submitted field into the caller's brief.

curl -X POST https://ringahuman.com/api/intake/rah_in_… \
  -H "content-type: application/json" \
  -d '{"name":"Maria Lopez","phone":"(512) 555-0142","company":"Bright Smile Dental","state":"TX","message":"Do you work with dental offices?"}'

→ 201 { "ok": true, "task_id": "task_…", "status": "open" }

Works with

We read Google Ads user_column_data, Facebook-style field_data, Typeform form_response and Tally data.fields natively. Anything else is read as plain key/value fields.

How fields are matched

• Phone: any field whose name contains phone, mobile, cell or tel. Required. US numbers only for now.
• Name: name, full_name, or first_name + last_name.
• Company: company, business, organization.
• State: a two-letter state or region field, otherwise the intake's default state or timezone. Used to enforce local calling hours.

Errors

401 unknown or revoked URL · 422 no valid phone number, or no state and no default · 409 the number is on your do-not-call list or already has an open task · 400 unreadable body. Test-mode accounts get simulated tasks.