Resource
Leads
Pipe inbound inquiries from your own intake forms (Squarespace, Webflow, custom) into Renvo.
The lead object
idstring (uuid) | Unique identifier. |
objectstring | Always `"lead"`. |
source_channelstring | Where the lead came from. |
customer_idstring (uuid) | Linked customer if known. |
statusstring | `NEW`, `QUALIFIED`, `CONVERTED`, `LOST`. |
raw_dataobject | Arbitrary JSON payload from the source form. |
Webhook events
Subscribe to receive notifications when lead resources change:
lead.receivedEndpoints
POST
/v1/leadsscope: read_writeCreate a lead
Body parameters
source_channelstring | Where it came from (default `api`). |
customer_idstring | Link to existing customer if known. |
raw_dataobject | Form fields, notes — anything JSON-serializable. |
Request
curl -X POST 'https://userenvo.com/api/v1/leads' \
-H 'Authorization: Bearer rv_live_…' \
-H 'Content-Type: application/json' \
-d '{
"source_channel": "<source_channel>",
"customer_id": "<customer_id>",
"raw_data": "<raw_data>"
}'Response
{
"object": "lead",
"id": "le_…",
"source_channel": "website",
"status": "NEW"
}