How to Integrate Replit with Buildium

1// Verify Buildium secrets are present at startup
2const required = ['BUILDIUM_CLIENT_ID', 'BUILDIUM_CLIENT_SECRET', 'BUILDIUM_API_BASE'];
3for (const key of required) {
4  if (!process.env[key]) {
5    throw new Error(`Missing secret: ${key}. Add it in Replit Secrets (lock icon 🔒).`);
6  }
7}
8console.log('Buildium credentials loaded. Client ID:', process.env.BUILDIUM_CLIENT_ID);

1// buildium.js — Buildium API client with OAuth 2.0 for Replit (Node.js)
2const axios = require('axios');
3const express = require('express');
4
5const CLIENT_ID = process.env.BUILDIUM_CLIENT_ID;
6const CLIENT_SECRET = process.env.BUILDIUM_CLIENT_SECRET;
7const API_BASE = process.env.BUILDIUM_API_BASE || 'https://api.buildium.com/v1';
8const TOKEN_URL = `${API_BASE}/oauth2/token`;
9
10// Token cache
11let cachedToken = null;
12let tokenExpiry = 0;
13
14async function getAccessToken() {
15  // Return cached token if still valid (with 60s buffer)
16  if (cachedToken && Date.now() < tokenExpiry - 60000) {
17    return cachedToken;
18  }
19  
20  const response = await axios.post(TOKEN_URL, new URLSearchParams({
21    grant_type: 'client_credentials',
22    client_id: CLIENT_ID,
23    client_secret: CLIENT_SECRET
24  }), {
25    headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
26  });
27  
28  cachedToken = response.data.access_token;
29  tokenExpiry = Date.now() + (response.data.expires_in * 1000);
30  return cachedToken;
31}
32
33async function buildiumGet(path, params = {}) {
34  const token = await getAccessToken();
35  const response = await axios.get(`${API_BASE}${path}`, {
36    headers: { Authorization: `Bearer ${token}` },
37    params
38  });
39  return { data: response.data, total: response.headers['x-total-count'] };
40}
41
42const app = express();
43app.use(express.json());
44
45// List all properties
46app.get('/api/properties', async (req, res) => {
47  try {
48    const { offset = 0, limit = 50 } = req.query;
49    const result = await buildiumGet('/properties/residential', { offset, limit });
50    res.json({ properties: result.data, total: result.total });
51  } catch (err) {
52    res.status(500).json({ error: err.response?.data || err.message });
53  }
54});
55
56// Get tenants for a property unit
57app.get('/api/units/:unitId/tenants', async (req, res) => {
58  try {
59    const result = await buildiumGet('/units/residencies', {
60      unitId: req.params.unitId
61    });
62    res.json(result.data);
63  } catch (err) {
64    res.status(500).json({ error: err.response?.data || err.message });
65  }
66});
67
68// Get maintenance requests
69app.get('/api/maintenance/requests', async (req, res) => {
70  try {
71    const { status = 'New', limit = 50 } = req.query;
72    const result = await buildiumGet('/maintenance/requests', { status, limit });
73    res.json({ requests: result.data, total: result.total });
74  } catch (err) {
75    res.status(500).json({ error: err.response?.data || err.message });
76  }
77});
78
79app.listen(3000, '0.0.0.0', () => console.log('Buildium server running on port 3000'));

1# buildium.py — Buildium API client with OAuth 2.0 for Replit (Python)
2import os
3import time
4import requests
5from flask import Flask, jsonify, request as flask_request
6
7CLIENT_ID = os.environ['BUILDIUM_CLIENT_ID']
8CLIENT_SECRET = os.environ['BUILDIUM_CLIENT_SECRET']
9API_BASE = os.environ.get('BUILDIUM_API_BASE', 'https://api.buildium.com/v1')
10TOKEN_URL = f'{API_BASE}/oauth2/token'
11
12class TokenManager:
13    def __init__(self):
14        self._token = None
15        self._expiry = 0
16    
17    def get_token(self) -> str:
18        if self._token and time.time() < self._expiry - 60:
19            return self._token
20        
21        response = requests.post(TOKEN_URL, data={
22            'grant_type': 'client_credentials',
23            'client_id': CLIENT_ID,
24            'client_secret': CLIENT_SECRET
25        })
26        response.raise_for_status()
27        token_data = response.json()
28        self._token = token_data['access_token']
29        self._expiry = time.time() + token_data.get('expires_in', 3600)
30        return self._token
31
32tokens = TokenManager()
33
34def buildium_get(path: str, params: dict = {}) -> dict:
35    """Make an authenticated GET request to the Buildium API."""
36    token = tokens.get_token()
37    response = requests.get(
38        f'{API_BASE}{path}',
39        headers={'Authorization': f'Bearer {token}'},
40        params=params
41    )
42    response.raise_for_status()
43    return {
44        'data': response.json(),
45        'total': response.headers.get('x-total-count')
46    }
47
48app = Flask(__name__)
49
50@app.route('/api/properties')
51def list_properties():
52    try:
53        offset = flask_request.args.get('offset', 0)
54        limit = flask_request.args.get('limit', 50)
55        result = buildium_get('/properties/residential', {'offset': offset, 'limit': limit})
56        return jsonify({'properties': result['data'], 'total': result['total']})
57    except Exception as e:
58        return jsonify({'error': str(e)}), 500
59
60@app.route('/api/maintenance/requests')
61def list_maintenance_requests():
62    try:
63        status = flask_request.args.get('status', 'New')
64        result = buildium_get('/maintenance/requests', {'status': status})
65        return jsonify({'requests': result['data'], 'total': result['total']})
66    except Exception as e:
67        return jsonify({'error': str(e)}), 500
68
69@app.route('/api/leases')
70def list_leases():
71    try:
72        result = buildium_get('/leases', {
73            'status': flask_request.args.get('status', 'Active')
74        })
75        return jsonify({'leases': result['data'], 'total': result['total']})
76    except Exception as e:
77        return jsonify({'error': str(e)}), 500
78
79if __name__ == '__main__':
80    app.run(host='0.0.0.0', port=3000)