Skip to main content

Purpose

Registers a new business for AI visibility tracking. Creates records in multiple tables and updates Clerk organization metadata.

Architecture

Request Body

{
  "business_name": "Acme Corp",
  "business_url": "https://acme.com",
  "tracking_type": "business",
  "clerk_org_id": "org_abc123",
  "clerk_user_id": "user_xyz789",
  "org_slug": "acme-corp"
}

What Gets Created

  1. clerk_organization_details - Links Clerk org to business
  2. entities - Business entity for tracking
  3. pre_payment_rankings - Initial ranking score (32-49)
  4. Clerk metadata - Business data on organization

Response Format

{
  "id": 1,
  "business_uuid": "uuid-...",
  "business_name": "Acme Corp",
  "created_at": "2024-01-15T10:30:00Z",
  "ranking_score": 42,
  "entity_id": "uuid-..."
}

Code Location

src/app/apis/onboarding/create_business/routes.py