Skip to main content
Upload a contact photo
The Hive Inspect API is a work in progress. It is available to a small group of accounts today, and the release for everyone is coming very soon.

Authorizations

Authorization
string
header
required

Your API key from Business Tools → API Access.

Path Parameters

contactId
string<uuid>
required

Body

multipart/form-data
file
file
required

jpg, png, gif or webp, up to 10 MB

Response

OK

id
string<uuid>
first_name
string
last_name
string | null
email
string<email>
cc_email
string<email> | null
phone
string | null
business_name
string | null
agency_name
string | null
address
string | null
address_line2
string | null
city
string | null
state
string | null
zip
string | null
country
string | null

ISO-2, e.g. US or CA

birthday
string<date> | null
website
string | null
social
object | null
notes
string | null
tags
object[]
roles
string[]

Distinct roles this contact has had on inspections

created_at
string<date-time>
updated_at
string<date-time>
photo_url
string | null

Signed link, valid for 1 hour

agency_id
string<uuid> | null

The agency (brokerage) this contact is linked to, from /v1/agencies. Null when agency_name is plain text.

uses_agency_address
boolean

true: the contact's address follows the agency's address

agency
object | null

The linked agency, when there is one

Last modified on October 2, 2026