---
title: API keys and webhooks
description: Connect HousingStreet to your other tools with API keys and event alerts.
canonical_url: https://housingstreet.com/help/enterprise/api-and-webhooks
md_url: https://housingstreet.com/help/enterprise/api-and-webhooks.md
last_updated: 2026-07-13
status: ga
relatedRoutes: ["/settings/security","/settings/webhooks"]
---

## What this is [#what-this-is]

An **API key** is a secret password your other software uses to read or write data in HousingStreet.

A **webhook** is a ping HousingStreet sends to your server when something happens — like a new lead or a sold listing.

<PlanBadge plans="['ENTERPRISE']" />

<UiPath path="Settings → Security (API Keys) · Settings → Webhooks" />

<DocScreenshot src="/help-media/enterprise/api-webhooks.png" alt="API keys list and webhook endpoint configuration in security settings" caption="Keys for your apps, webhooks for live updates" />

## Steps — API keys [#steps--api-keys]

<Steps>
  <Step title="Open API keys">
    Go to **Settings → Security**. Scroll to **API Keys**.
  </Step>

  <Step title="Create a key">
    Click **Create key**. Give it a name you will remember (for example "CRM sync"). Copy the key right away — you cannot see it again.
  </Step>

  <Step title="Use it in your app">
    Paste the key into your integration tool. Test one simple call (for example, list properties).
  </Step>

  <Step title="Revoke old keys">
    Delete any key you no longer use. Treat keys like passwords — never share them in chat or email.
  </Step>
</Steps>

## Steps — webhooks [#steps--webhooks]

<Steps>
  <Step title="Open webhooks">
    Go to **Settings → Webhooks**.
  </Step>

  <Step title="Add an endpoint">
    Click **Add webhook**. Paste the URL where your server listens for events.
  </Step>

  <Step title="Pick events">
    Choose which events to send — for example **lead.created** or **property.updated**.
  </Step>

  <Step title="Send a test">
    Click **Test**. Your server should receive a sample payload. Fix the URL if it fails.
  </Step>
</Steps>

## Expected result [#expected-result]

Your other tools can pull data with the API key. Your server gets instant alerts when chosen events happen.

<RelatedAdminLink href="/settings/webhooks" label="Open webhooks" />