Qbox
Documentation

Level 1 · Connected

Requests

The centres' information and waiting-list requests, in your software.

When someone asks for information on a centre's listing, joins the waiting list for a full size or asks to be notified when it opens, you get the request, if the operator wants them in their software. By default they reach your software and their email; they can change this in “Connect your software”.

How they arrive

  • Right away, with the lead.created webhook (see Webhooks).
  • If a webhook was missed, with GET /leads: those from the last 30 days, oldest first, with since, limit (up to 100) and cursor (the previous page's nextCursor).
FieldNotes
idIts identifier in Qbox
facilityIdThe centre's id in your software
kindcontact (information), waitlist (waiting list) or opening (notify me when it opens)
name and emailAlways
phoneWith its prefix: +34 612345678. Always, except in opening, where it's optional
localeThe language they wrote in: es, en, fr, de, it or pt
categoryThe size they're interested in: closet, dressingRoom, room, studio, flat or house
unitIdThe unit they picked on the floor plan, if any
messageWhat they wrote, if anything
statusnew or handled
consentAtWhen they agreed to the centre contacting them
createdAtWhen they sent it

Marking it as handled

PUT /leads/{leadId}/status with {"status": "handled"}: it's handled in Qbox too.

Personal data

Your software processes this data on behalf of the operator, as a data processor, and only to answer that request: see the terms for software. Once delivered, Qbox doesn't keep the person's details in the webhook.

Questions? Write to us at team@findqbox.com.