Skip to main content

​
Create Your First Broker

Brokers are business professionals who list and sell businesses on Venturu. Every listing created through the API needs a broker, so let’s create one.

​
Quick Start

Endpoint: PUT /partner/v1/brokers/{externalBrokerId} What you need:
  • Your API key
  • A unique ID from your system (like your broker’s employee ID or email)
  • Basic broker information (name, email)
1

Choose an External ID

Pick a stable, unique identifier from your system. Good choices:
  • Employee ID: EMP-12345
  • Email-based: jane-doe
  • Database ID: broker-789
This ID is permanent - once you use it, it always refers to this broker.
2

Prepare Your Request

Create a JSON object with the broker’s information:
{
  "name": "Jane Doe",
  "email": "jane@realestate.com",
  "phone": "+1-555-0123"
}
3

Send the Request

curl -X PUT "https://www.venturu.com/api/partner/v1/brokers/BROKER-789" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jane Doe",
    "email": "jane@realestate.com",
    "phone": "+1-555-0123"
  }'
4

Success!

You’ll get back the broker’s Venturu ID and profile URL:
{
  "status": "success",
  "message": "Broker created successfully",
  "venturuBrokerId": "cmhnmzme1000b396q58yx17fm",
  "venturuProfileUrl": "https://www.venturu.com/u/jane-doe"
}
Broker created! They can now have listings assigned to them.

​
Full Example with All Fields

Want to create a complete, professional profile? Here’s an example with all optional fields: 
{
  "name": "Jane Doe",
  "email": "jane@realestate.com",
  "phone": "+1-555-0123",
  "avatarUrl": "https://example.com/photos/jane.jpg",
  "forwardingEmail": "leads-jane@crm.example.com",
  "profile": {
    "bio": "With over 10 years of experience in business brokerage, Jane specializes in restaurant and retail acquisitions.",
    "website": "https://janedoe.com",
    "linkedInUrl": "https://linkedin.com/in/janedoe"
  },
  "licenses": [
    {
      "licenseNumber": "BK123456",
      "state": "Florida",
      "country": "US"
    }
  ],
  "serviceAreas": [
    {
      "city": "Miami",
      "state": "Florida",
      "country": "US"
    }
  ]
}

​
Field Reference

  • name: Broker’s full name
  • email: Primary email address (used for Venturu account)
  • forwardingEmail: Send leads directly to your CRM
Many CRMs provide unique email addresses that automatically create leads. Set this field to pipe Venturu leads straight into your system!
  • licenses: Array of license objects (licenseNumber, state, country)
  • serviceAreas: Where the broker operates (can specify by city, county, or state)
  • profile.website: Personal or company website
  • profile.linkedInUrl: LinkedIn profile URL

​
Common Questions

No problem! If you use the same externalBrokerId, the broker will be updated instead of creating a duplicate. See Updating a Broker for details.
No - the externalBrokerId is permanent. It’s the link between your system and Venturu. Choose wisely!
Provide a URL to the photo with avatarUrl. We’ll download and optimize it. Photos are processed asynchronously, so they might not appear immediately.
Set the forwardingEmail field to your CRM’s lead ingestion email. When someone contacts this broker on Venturu, we’ll forward the lead there automatically.

​
Next Steps

Update Broker Info

Learn how to update broker details

Create a Listing

Now create a listing for this broker

API Reference

Full API documentation

Core Concepts

Understanding external IDs