Salesbuildr API Patterns

Overview

The Salesbuildr public API provides REST endpoints for managing CRM data. All requests require an API key and follow consistent patterns for pagination and error handling.

Authentication

Every API request must include the api-key header:

Headers:
  api-key: ${SALESBUILDR_API_KEY}
  Content-Type: application/json

API keys are generated in the Salesbuildr portal under Settings > API Keys.

Base URL

https://portal.salesbuildr.com/public-api

Pagination

All list endpoints use offset-based pagination:

Example: To get page 2 with 25 results per page:

GET /companies?from=25&size=25

Rate Limiting

• Limit: 500 requests per 10 minutes
• Strategy: Implement conservative request patterns
• Backoff: If rate limited, wait and retry with exponential backoff

Error Handling

Common Request Patterns

Search with filtering

GET /companies?search=acme&from=0&size=25

Get by ID

GET /companies/12345

Create resource

POST /contacts
Content-Type: application/json

{
  "first_name": "John",
  "last_name": "Doe",
  "email": "[email protected]",
  "company_id": 12345
}

Update resource

PATCH /opportunities/12345
Content-Type: application/json

{
  "stage": "proposal",
  "value": 15000
}