RingPort lead intake API

Lead webhook

Post website, ad, or form leads to this URL. At least one of phone or email is required.

Back

Endpoint

Use HTTP POST with JSON or form data.

Accepted Fields

Namename, full_name, fullName, contact_name, customer_name, first_name, last_name
Phonephone, phone_number, phoneNumber, mobile, caller_phone, contact_phone
Emailemail, email_address, emailAddress, contact_email
Needneed, service, service_needed, request, message, description, notes, comments
Sourcesource, lead_source, utm_source, platform, provider
Statusnew, qualified, unqualified, callback, appointment, transferred, unreachable

JSON Example

cURL Example

JavaScript Example

Responses

{
  "ok": true,
  "duplicate": false,
  "eventId": 123,
  "leadId": 456,
  "status": "new"
}
{
  "ok": true,
  "duplicate": true,
  "eventId": 124,
  "leadId": 456,
  "status": "new"
}
{
  "ok": false,
  "status": "rejected",
  "error": "Lead webhook requires at least a phone or email"
}