Skip to main content
POST
Add a client who called

Authorizations

Authorization
string
header
required

Authorization: Bearer

Headers

Idempotency-Key
string

A unique value for this creation (for example a UUID). A request repeated with the same value within 10 minutes returns what the first one created, without creating anything else: the listing for POST /listings, the contact for POST /leads, the message for POST /leads/{lead}/messages. For listings and messages, only the first 64 characters count.

Path Parameters

code
string
required

The listing's public code (8 characters, as in its URL on Housera).

Query Parameters

locale
enum<string>
default:en

The response language, ro or en. It changes error messages (title, detail), labels and, when the listing has an approved translation in that language, its title and description. Codes are the same in every language. It takes precedence over Accept-Language and over the account's language.

Available options:
ro,
en

Body

application/json
starts_at
string
required

Start time.

Maximum string length: 40
duration_min
enum<integer>
required

How long a viewing lasts, in minutes: 15, 30, 45, 60 or 90.

Available options:
15,
30,
45,
60,
90
name
string
required

Name.

Maximum string length: 120
phone
string | null

Phone.

Maximum string length: 32
Pattern: ^\+?[0-9 ()\-]{6,32}$

Response

The request succeeded.

data
ViewingSlotApiResource · object
required

The result of the request.