curl -X POST https://searchcompany-main.up.railway.app/api/business \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
-d '{
"business_name": "Nike",
"business_url": "https://nike.com",
"tracking_type": "business",
"clerk_org_id": "org_2abc123",
"clerk_user_id": "user_2xyz789",
"org_slug": "nike-123456"
}'
{
"id": 42,
"business_uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"business_name": "Nike",
"created_at": "2024-01-15T10:30:00Z",
"ranking_score": 38,
"entity_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
🔵 POST - Create Business
Create Organization Record
Create organization metadata and business entity
POST
/
api
/
business
curl -X POST https://searchcompany-main.up.railway.app/api/business \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
-d '{
"business_name": "Nike",
"business_url": "https://nike.com",
"tracking_type": "business",
"clerk_org_id": "org_2abc123",
"clerk_user_id": "user_2xyz789",
"org_slug": "nike-123456"
}'
{
"id": 42,
"business_uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"business_name": "Nike",
"created_at": "2024-01-15T10:30:00Z",
"ranking_score": 38,
"entity_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
Creates an organization details record in
clerk_organization_details table and a business entity in the entities table. This is called during onboarding after the Clerk organization is created.
What This Does
- Creates organization metadata in
clerk_organization_details(links Clerk org to database) - Gets/creates ranking score in the pre-payment rankings database (32-49 range)
- Creates business entity in
entitiestable (needed for visibility tracking) - Updates Clerk metadata with business info for frontend access
Request Body
string
required
The name of the business (e.g., “Nike”, “Acme Corp”)
string
The main website URL for the business
string
Type of tracking:
"business" or "product"string
The Clerk organization ID (e.g.,
org_2abc123)string
The Clerk user ID who created the business
string
The Clerk organization slug (e.g.,
nike-123456). Used to create the entity in the entities table.Response
integer
Database record ID in
clerk_organization_detailsstring
Unique identifier (UUID v4)
string
The organization name
string
ISO 8601 timestamp of creation
integer
Pre-payment AI visibility ranking score (32-49)
string
The UUID of the created entity in the
entities tableThe
entity_id is created here so that Materialize Score can immediately copy the ranking score to the main database after onboarding completes.curl -X POST https://searchcompany-main.up.railway.app/api/business \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
-d '{
"business_name": "Nike",
"business_url": "https://nike.com",
"tracking_type": "business",
"clerk_org_id": "org_2abc123",
"clerk_user_id": "user_2xyz789",
"org_slug": "nike-123456"
}'
{
"id": 42,
"business_uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"business_name": "Nike",
"created_at": "2024-01-15T10:30:00Z",
"ranking_score": 38,
"entity_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}