1. [    Home ](/)
2. [Guides](/guides)
3. [Getting Started](/guides?category=18)
4. Your First API Integration
 
 Easy Getting Started      30 min       5 steps      8 min read  

# Your First API Integration

  A  admin  March 14, 2026   (Updated April 22, 2026)  

 

 

       

 

 

Image

   ![Your First API Integration](/sites/default/files/styles/16_9_512x288_focal_point_webp/public/guide-images/your-first-api-integration.png.webp?itok=QVpsbv19 "Your First API Integration") 

 





 

 

 ##     Prerequisites 

Prerequisites



 

 

 

 

 

 ## On this page

  
  5 steps total 

 [    Back to top ](#main-content) 

 This hands-on guide walks you through building your first API integration step by step. By the end, you will have a working integration that queries building data and handles errors gracefully.

## Step 1: Set Up Your Environment

Install the SDK for your preferred language and configure your API credentials. Create a .env file with your API key:

CONNECTBASE\_API\_KEY=sk\_test\_your\_key\_here

## Step 2: Initialize the Client

const client = new ConnectbaseClient({\\n apiKey: process.env.CONNECTBASE\_API\_KEY\\n});

## Step 3: Make Your First API Call

Query a building by address to get structured data:

const result = await client.buildings.lookup({\\n street: "123 Main St",\\n city: "Austin",\\n state: "TX"\\n});\\nconsole.log(result.building\_id, result.coordinates);

## Step 4: Handle Errors

Wrap API calls in try/catch and handle common error types:

try {\\n const result = await client.buildings.get(id);\\n} catch (err) {\\n if (err.status === 404) {\\n console.log("Building not found");\\n } else if (err.status === 429) {\\n console.log("Rate limited, retry after", err.retryAfter);\\n }\\n}

## Step 5: Deploy to Production

Switch from test to live API key and enable retry logic for production reliability.



 

 

 

 ### Tags

 

 

  [     Previous Implementing OAuth 2.0 Authentication  ](/guides/implementing-oauth-20-authentication)