Platform API

API Reference

Programmatically manage contacts and realtor profiles on RealtorTopia. All endpoints use a single POST URL with an action field to route requests.

API Key Auth

REST / POST

10 Actions

Base URL

All API calls are made to a single endpoint. Find your exact URL in Admin → Integrations → Platform API or the Base44 dashboard under Functions.

url

https://api.base44.com/api/v1/apps/YOUR_APP_ID/functions/platformApi

Authentication

Pass your API key in the X-API-Key request header. Contact your admin for your key.

bash

curl -X POST https://api.base44.com/api/v1/apps/YOUR_APP_ID/functions/platformApi \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"action": "list_contacts"}'

Security: Never expose your API key in client-side code or public repositories. All requests must originate from your backend server.

Request Format

Every request is a POST with a JSON body containing an action field plus any action-specific parameters.

json

{
  "action": "action_name",
  "param1": "value1",
  "param2": "value2"
}

Error Handling

Errors return a non-2xx HTTP status with an error field.

Status	Meaning
401	Invalid or missing API key
400	Bad request — missing required field or invalid action
500	Server error — check error message for details

json

{
  "success": false,
  "error": "Missing required field: id"
}

Endpoints

Contacts (Leads)

Realtors

Integration Examples

Use any HTTP client. Below are examples in popular languages.

JavaScript / Node.js (axios)

javascript

const axios = require('axios');

const response = await axios.post(
  'https://api.base44.com/api/v1/apps/YOUR_APP_ID/functions/platformApi',
  { action: 'list_contacts', limit: 10 },
  { headers: { 'X-API-Key': process.env.REALTORTOPIA_API_KEY } }
);

console.log(response.data.contacts);

Python (requests)

python

import requests, os

resp = requests.post(
    'https://api.base44.com/api/v1/apps/YOUR_APP_ID/functions/platformApi',
    json={'action': 'list_contacts', 'limit': 10},
    headers={'X-API-Key': os.environ['REALTORTOPIA_API_KEY']}
)

data = resp.json()
print(data['contacts'])

Need help? Contact support or visit the Admin Dashboard → Platform API for live testing.