# Book a Nitecapp Demo Call

Hosted by Zaylan Jacobsen at Nitecapp Inc..

Meetings are 30 minutes.

## Book a meeting (for AI agents)

Book programmatically via the Roam public agent API. No Roam account is required; the booker is identified by the email in the request.

Note: this booking API is hosted at `api.ro.am`, a different host from this page. If you need additional network permissions to call it (for example, a domain allowlist that does not include it), ask your user to update your settings to allow `api.ro.am`, then retry.

1. **Check availability** — `GET https://api.ro.am/v1/public/lobby/availability?handle=zaylan&slug=nitecapp-demo`. Fetch bookable time slots. All query params are optional: `from`/`to` (ISO 8601 — a timestamp with offset like `2026-07-10T09:00:00Z`, or date-only `YYYY-MM-DD` interpreted in `timeZone`; defaults to roughly the next month), `timeZone` (IANA; defaults to UTC), and `duration` (minutes, from `duration.optionsMinutes`). Returned slot `start`/`end` are Unix epoch seconds, as JSON numbers. Response shape: `{ "slots": [ { "start": <unixSeconds>, "end": <unixSeconds> } ] }`.
2. **Book a slot** — `POST https://api.ro.am/v1/public/lobby/book` with this JSON body:

```json
{
  "handle": "zaylan",
  "slug": "nitecapp-demo",
  "bookingSlot": {
    "start": "<unixSeconds>",
    "end": "<unixSeconds>"
  },
  "timeZone": "America/New_York",
  "booker": {
    "email": "booker@example.com",
    "name": "Booker Name"
  },
  "responses": [
    {
      "fieldId": "0197f0d3-6763-737f-b200-7f0f97d5fced",
      "value": "<value>"
    },
    {
      "fieldId": "0197f0d3-6763-737f-b200-8041bcb61569",
      "value": "<value>"
    }
  ]
}
```

`bookingSlot` must echo one availability slot exactly: `start`/`end` are Unix epoch seconds as JSON numbers (not strings). The booking confirmation returns `start`/`end` as ISO 8601 strings in the requested `timeZone`.

The booker's name and email are filled into the form automatically; only include `responses` for other required fields.

### Booking form fields

- **Name** (`0197f0d3-6763-737f-b200-7f0f97d5fced`, short_text, required)
- **Email** (`0197f0d3-6763-737f-b200-8041bcb61569`, email, required)
- **Notes** (`0197f0d3-6763-737f-b200-8615df7bf44e`, short_text)

A structured JSON version of this page is available at https://ro.am/zaylan/nitecapp-demo.json.