---
title: "Create Demo Request"
method: POST
path: "/api/v1/leads/demo-requests"
tags: ["Leads"]
---

# Create Demo Request

`POST /api/v1/leads/demo-requests`

## Request

- Base URL: `https://geo.sig.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://geo.sig.ai/api/v1/leads/demo-requests`
- Auth: none declared

Create a new demo request.

Rate limited to 5 requests per hour per IP to prevent spam.
Sends notifications to sales team.

## Request body

- DemoRequestCreate: Schema for creating a demo request.
  - `email` string, email, required
  - `full_name` string, required: Full name is required
  - `company` string, required: Company name is required
  - `job_title` string, nullable
  - `phone` string, nullable
  - `company_size` string, nullable: Company size: '1-10', '11-50', '51-200', '201-1000', '1000+'
  - `use_case` string, nullable: What they want to use the platform for
  - `urgency` string, nullable: Urgency: 'asap', 'this_month', 'this_quarter', 'exploring'
  - `preferred_time` string, nullable: Preferred time for demo
  - `source` string, nullable: Source page (e.g., 'landing_page', 'pricing_page')
  - `utm_source` string, nullable
  - `utm_medium` string, nullable
  - `utm_campaign` string, nullable
  - `metadata` object, nullable

## Response `201`

Successful Response

- DemoRequestResponse: Schema for demo request response.
  - `id` string, uuid, required
  - `email` string, required
  - `full_name` string, required
  - `company` string, required
  - `job_title` string, nullable, required
  - `phone` string, nullable, required
  - `company_size` string, nullable, required
  - `use_case` string, nullable, required
  - `urgency` string, nullable, required
  - `status` string, required
  - `created_at` string, date-time, required
  - `scheduled_at` string, date-time, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api.md) · [All operations](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api/revisions/3ec39f9be9e0?raw)