Renvo
API docs
Resource

Customers

People who rent from you. Look up by email, sync new bookings from external tools, or update contact info.

The customer object

id
string (uuid)
Unique identifier.
object
string
Always `"customer"`.
full_name
string
Customer's full name.
email
string
Email address.
phone
string
Phone (E.164).
preferred_language
string
BCP 47 tag (`en`, `zh`).
source_channel
string
Acquisition channel.
is_returning
boolean
Has rented before.
total_rentals
integer
Lifetime rental count.
overall_score
number
Renvo trust score (0–100).
created_at
string (iso8601)
Creation time.
Webhook events

Subscribe to receive notifications when customer resources change:

customer.createdcustomer.updated

Endpoints

GET/v1/customersscope: read

List customers

Query parameters
email
string
Exact-match filter.
limit
integer
Default 20. Max 100.
starting_after
string
Cursor.
Request
curl -X GET 'https://userenvo.com/api/v1/customers' \
  -H 'Authorization: Bearer rv_live_…'
Response
{
  "object": "list",
  "has_more": false,
  "next_cursor": null,
  "data": [
    {
      "object": "customer",
      "id": "cu_…",
      "full_name": "Jane Doe",
      "email": "jane@example.com"
    }
  ]
}
GET/v1/customers/{id}scope: read

Retrieve a customer

Path parameters
idrequired
string
Customer id.
Request
curl -X GET 'https://userenvo.com/api/v1/customers/a4d2e1c0-9b…' \
  -H 'Authorization: Bearer rv_live_…'
Response
{
  "object": "customer",
  "id": "cu_…",
  "full_name": "Jane Doe"
}
POST/v1/customersscope: read_write

Create a customer

Body parameters
full_namerequired
string
Customer name.
email
string
Email address.
phone
string
E.164 phone.
preferred_language
string
BCP 47 (default `en`).
source_channel
string
Acquisition channel.
Request
curl -X POST 'https://userenvo.com/api/v1/customers' \
  -H 'Authorization: Bearer rv_live_…' \
  -H 'Content-Type: application/json' \
  -d '{
       "full_name": "<full_name>",
       "email": "<email>",
       "phone": "<phone>"
     }'
Response
{
  "object": "customer",
  "id": "cu_…",
  "full_name": "Jane Doe"
}
PATCH/v1/customers/{id}scope: read_write

Update a customer

Path parameters
idrequired
string
Customer id.
Body parameters
email
string
New email.
phone
string
New phone.
notes
string
Internal notes.
Request
curl -X PATCH 'https://userenvo.com/api/v1/customers/a4d2e1c0-9b…' \
  -H 'Authorization: Bearer rv_live_…' \
  -H 'Content-Type: application/json' \
  -d '{
       "email": "<email>",
       "phone": "<phone>",
       "notes": "<notes>"
     }'
Response
{
  "object": "customer",
  "id": "cu_…",
  "email": "new@example.com"
}