API Documentation

Integrate CRM Baby with your applications using our REST API

Version 1.0

Base URL

https://crmbaby.com/api

All API requests should be made to this base URL. HTTPS is required for all requests.

Authentication

CRM Baby uses API keys for authentication. You can generate API keys from your account settings.

API Key Authentication

curl -X GET "https://crmbaby.com/api/companies" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Coming Soon

API key authentication is currently in development. For now, form submissions work without authentication.

Form Submissions

Live

Submit form data to create companies in CRM Baby. This endpoint is public and doesn't require authentication.

POST /form-submit/{tenant_id}/{form_id}

Submit form data to create a new company record.

Parameters

Parameter Type Description
tenant_id string Your tenant ID
form_id string The form ID from Form Builder

Request Body (Form Data)

name=Acme Corporation
first_name=John
last_name=Doe
contact_email=john@acme.com
contact_phone=555-123-4567
website_url=https://acme.com
custom_field_1=Google Ads Customer ID

Example Request

curl -X POST "https://crmbaby.com/api/form-submit/2/abc123" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "name=Acme Corporation&first_name=John&last_name=Doe&contact_email=john@acme.com"

Response

{
  "success": true,
  "message": "Thank you! Your information has been submitted."
}

Companies API

Coming Soon

Manage companies in your CRM programmatically.

GET /companies

Retrieve a list of all companies in your CRM.

GET /companies/{id}

Retrieve details for a specific company.

POST /companies

Create a new company record.

PUT /companies/{id}

Update an existing company record.

These endpoints are currently in development and will be available soon.

Custom Fields API

Coming Soon

Manage custom fields and their values programmatically.

GET /custom-fields

Retrieve all custom fields and their configurations.

POST /custom-fields

Create a new custom field definition.

Pro Feature

Custom Fields API will be available for Pro subscribers.

Error Handling

CRM Baby uses conventional HTTP response codes and returns JSON-formatted error responses.

HTTP Status Codes

Code Description
200 OK - Request succeeded
400 Bad Request - Invalid parameters
401 Unauthorized - Invalid API key
403 Forbidden - Access denied (e.g., Test Mode)
404 Not Found - Resource doesn't exist
429 Too Many Requests - Rate limit exceeded

Error Response Format

{
  "success": false,
  "error": "This form is in Test Mode. Upgrade to Pro to activate live lead capture.",
  "test_mode": true
}

Rate Limits

API rate limits help ensure fair usage and system stability.

Free Plan

  • • 100 form submissions per day
  • • 10 API requests per minute
  • • Form submissions in Test Mode

Pro Plan ($9/month)

  • • Unlimited form submissions
  • • 1,000 API requests per minute
  • • Live lead capture
  • • Priority support

SDKs & Examples

Code examples and integration guides for popular platforms.

JavaScript

fetch('/api/form-submit/2/abc123', {
  method: 'POST',
  body: new FormData(form)
})

Perfect for web forms and AJAX submissions

cURL

curl -X POST \
  -d "name=Company" \
  /api/form-submit/2/abc123

Command line testing and automation

Python

import requests

requests.post(url, data=form_data)

Server-side integrations and automation

Need Help?

Contact our support team at api@crmbaby.com for integration assistance.