How to Integrate Bolt.new with Buildium

1// lib/buildium.ts
2const BUILDIUM_BASE_URL = 'https://api.buildium.com/api/v1';
3
4function getAuthHeader(): string {
5  const clientId = process.env.BUILDIUM_CLIENT_ID!;
6  const clientSecret = process.env.BUILDIUM_CLIENT_SECRET!;
7  const encoded = Buffer.from(`${clientId}:${clientSecret}`).toString('base64');
8  return `Basic ${encoded}`;
9}
10
11export interface BuildiumListResponse<T> {
12  data: T[];
13  total: number;
14  page: number;
15  pageSize: number;
16}
17
18export async function buildiumFetch<T>(
19  endpoint: string,
20  params: Record<string, string | number> = {}
21): Promise<BuildiumListResponse<T>> {
22  const url = new URL(`${BUILDIUM_BASE_URL}${endpoint}`);
23  Object.entries(params).forEach(([k, v]) => url.searchParams.set(k, String(v)));
24
25  const response = await fetch(url.toString(), {
26    headers: {
27      Authorization: getAuthHeader(),
28      'Content-Type': 'application/json',
29    },
30  });
31
32  if (!response.ok) {
33    const error = await response.text();
34    throw new Error(`Buildium API error ${response.status}: ${error}`);
35  }
36
37  return response.json();
38}
39
40export async function buildiumPost<T>(
41  endpoint: string,
42  body: unknown
43): Promise<T> {
44  const response = await fetch(`${BUILDIUM_BASE_URL}${endpoint}`, {
45    method: 'POST',
46    headers: {
47      Authorization: getAuthHeader(),
48      'Content-Type': 'application/json',
49    },
50    body: JSON.stringify(body),
51  });
52
53  if (!response.ok) {
54    const error = await response.text();
55    throw new Error(`Buildium API error ${response.status}: ${error}`);
56  }
57
58  return response.json();
59}

1// app/api/buildium/properties/route.ts
2import { NextResponse } from 'next/server';
3import { buildiumFetch } from '@/lib/buildium';
4
5export async function GET() {
6  try {
7    const result = await buildiumFetch<{
8      Id: number;
9      Address: { AddressLine1: string; City: string; State: string; PostalCode: string };
10      Status: string;
11      NumberUnits: number;
12    }>('/rentals', { limit: 100, offset: 0 });
13
14    const properties = result.data.map((p) => ({
15      id: p.Id,
16      address: {
17        street: p.Address.AddressLine1,
18        city: p.Address.City,
19        state: p.Address.State,
20        zip: p.Address.PostalCode,
21      },
22      status: p.Status,
23      unitCount: p.NumberUnits,
24    }));
25
26    return NextResponse.json({ properties, total: result.total });
27  } catch (error) {
28    console.error('Buildium properties error:', error);
29    return NextResponse.json({ error: 'Failed to fetch properties' }, { status: 500 });
30  }
31}

1// app/api/buildium/leases/route.ts
2import { NextResponse } from 'next/server';
3import { buildiumFetch } from '@/lib/buildium';
4
5interface Lease {
6  Id: number;
7  Unit: { Id: number; UnitNumber: string; Address: { AddressLine1: string } };
8  Tenants: Array<{ Id: number; FirstName: string; LastName: string; Email: string }>;
9  Rent: number;
10  StartDate: string;
11  EndDate: string;
12  LeaseStatus: string;
13}
14
15interface OutstandingBalance {
16  TotalBalance: number;
17}
18
19export async function GET() {
20  try {
21    const leasesResult = await buildiumFetch<Lease>('/rentals/leases', {
22      status: 'Active',
23      limit: 50,
24      offset: 0,
25    });
26
27    const leases = await Promise.all(
28      leasesResult.data.map(async (lease) => {
29        let outstandingBalance = 0;
30        try {
31          const balanceResult = await buildiumFetch<OutstandingBalance>(
32            `/rentals/leases/${lease.Id}/outstandingbalances`
33          );
34          outstandingBalance = balanceResult.data[0]?.TotalBalance ?? 0;
35        } catch {
36          // Balance fetch failed — use 0
37        }
38
39        const primaryTenant = lease.Tenants[0];
40        return {
41          id: lease.Id,
42          unit: lease.Unit.UnitNumber,
43          propertyAddress: lease.Unit.Address.AddressLine1,
44          tenantName: primaryTenant
45            ? `${primaryTenant.FirstName} ${primaryTenant.LastName}`
46            : 'Unknown',
47          tenantEmail: primaryTenant?.Email ?? '',
48          monthlyRent: lease.Rent,
49          startDate: lease.StartDate,
50          endDate: lease.EndDate,
51          outstandingBalance,
52        };
53      })
54    );
55
56    return NextResponse.json({ leases, total: leasesResult.total });
57  } catch (error) {
58    console.error('Buildium leases error:', error);
59    return NextResponse.json({ error: 'Failed to fetch leases' }, { status: 500 });
60  }
61}

1// app/api/buildium/webhook/route.ts
2import { NextRequest, NextResponse } from 'next/server';
3import crypto from 'crypto';
4
5// NOTE: Webhooks only work on deployed apps (Netlify/Bolt Cloud)
6// The WebContainer cannot receive incoming HTTP connections
7export async function POST(request: NextRequest) {
8  const body = await request.text();
9  const signature = request.headers.get('buildium-signature') ?? '';
10
11  // Verify webhook signature
12  const webhookSecret = process.env.BUILDIUM_WEBHOOK_SECRET!;
13  const expectedSig = crypto
14    .createHmac('sha256', webhookSecret)
15    .update(body)
16    .digest('hex');
17
18  if (signature !== expectedSig) {
19    return NextResponse.json({ error: 'Invalid signature' }, { status: 401 });
20  }
21
22  const event = JSON.parse(body);
23  console.log('Buildium webhook event:', event.EventType);
24
25  // Handle different event types
26  switch (event.EventType) {
27    case 'Payment_Created':
28      // Trigger dashboard refresh or update payment status in DB
29      break;
30    case 'WorkOrder_Created':
31    case 'WorkOrder_Updated':
32      // Update work order status in DB or notify team
33      break;
34    case 'Lease_Created':
35      // New lease signed — update occupancy metrics
36      break;
37  }
38
39  return NextResponse.json({ received: true });
40}