> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fieldiu.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Lead

> Creates a new lead record in the FieldIU sales pipeline.



## OpenAPI

````yaml POST /api/v1/leads
openapi: 3.0.1
info:
  title: Fieldiu Integration API
  description: Internal integration endpoints for Fieldiu.
  version: v1
  contact:
    name: Fieldiu Support
  license:
    name: Proprietary
servers:
  - url: https://integration.fieldiu.online
security:
  - ApiKeyAuth: []
    OrgIdAuth: []
paths:
  /api/v1/leads:
    post:
      tags:
        - Leads
      summary: Create Lead
      description: Creates a new lead record in the FieldIU sales pipeline.
      operationId: createLead
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LeadRequest'
      responses:
        '200':
          description: Lead created successfully
components:
  schemas:
    LeadRequest:
      type: object
      properties:
        firstName:
          type: string
          nullable: true
          description: First name
        lastName:
          type: string
          nullable: true
          description: Last name
        title:
          type: string
          nullable: true
          description: Job title
        companyName:
          type: string
          nullable: true
          description: Company name
        email:
          type: string
          nullable: true
          description: Email address
        mobilePhone:
          type: string
          nullable: true
          description: Mobile phone number
        businessPhone:
          type: string
          nullable: true
          description: Business phone number
        leadSource:
          type: integer
          nullable: true
          description: Lead source code
        accountType:
          type: integer
          nullable: true
          description: Account type code
        rating:
          type: integer
          nullable: true
          description: Lead quality rating code
        estimatedValue:
          type: number
          format: double
          nullable: true
          description: Estimated deal value
        estimatedCloseDate:
          type: string
          format: date-time
          nullable: true
          description: Estimated close date (ISO 8601)
        buildingLocation:
          type: string
          nullable: true
          description: Building or location name
        street1:
          type: string
          nullable: true
          description: Street address line 1
        street2:
          type: string
          nullable: true
          description: Street address line 2
        city:
          type: string
          nullable: true
          description: City
        postalCode:
          type: string
          nullable: true
          description: Postal / ZIP code
        state:
          type: string
          nullable: true
          description: State or province
        country:
          type: string
          nullable: true
          description: Country
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      description: Your organization's API key
    OrgIdAuth:
      type: apiKey
      in: header
      name: X-ORG-ID
      description: Your organization's identifier

````