Brokerkit API

Overview

The BrokerKit API allows you to programmatically create and update contacts (leads and agents) in your BrokerKit account. You can use it for integrations with other platforms, automated imports, and custom workflows.

For the complete API documentation — including all endpoints, parameters, request/response formats, and interactive testing — visit the BrokerKit API Portal:

BrokerKit API Documentation Portal

The portal lets you browse all available endpoints, see detailed parameter descriptions, and test API queries directly without writing any code.

Getting Started

API URL

The API base URL is:

https://api.getbrokerkit.com/v2

All request URLs must be appended to this base URL. For example, to create a lead, make a POST request to https://api.getbrokerkit.com/v2/leads.

Finding Your API Key

1. Log into your BrokerKit account
2. Navigate to Team Settings
3. Under Team Api Key, click the Copy to Clipboard button

Request Headers

With every request, you must include the following headers:

• Authorization: Token token=YOUR_API_KEY
• Content-Type: application/json

What Can You Do with the API?

• Create contacts — Add new recruiting leads or retention agents
• Update contacts — Modify existing records (duplicate detection by email or agent ID)
• Test requests — Validate your API calls without saving data by setting test: true
• Attach files — Include resumes and documents via public URLs

For the full list of endpoints, parameters, valid values, and example requests, see the API Documentation Portal.

Using Zapier (No Code Required)

If you prefer a no-code approach, you can connect BrokerKit with hundreds of apps using Zapier. See our step-by-step guide:

Integrating with Zapier for Importing Leads or Agents

Quick Reference

Response Codes

Key Things to Know

• Duplicate detection: Records match on email address or agent_id. If a duplicate is found, the existing record is updated; otherwise, a new record is created.
• Test mode: Include "test": true in your request to validate without saving data. You can also test queries interactively using the API Documentation Portal.
• Recruiting vs. Retention: To create an agent in retention instead of a recruiting lead, include "product": "retention" in your request.
• File attachments: Use resume_url for a PDF resume and document_urls for other files. Files must be publicly accessible.

For the complete parameter reference, example requests, and response formats, visit the API Documentation Portal.