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

# Create a lead (callback, quote, finance, insurance) with the buyer's consent

> Create a lead for a dealer (callback, quote, finance or insurance) with the buyer's explicit consent; your key's prefix is recorded as the source.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/leads
openapi: 3.1.0
info:
  title: Truckaurbus API
  version: v1
  description: >-
    The public v1 API at https://api.truckaurbus.com/v1. Authenticate with an
    API key in the Authorization header: Bearer tab_live_...
servers:
  - url: https://api.truckaurbus.com
security: []
paths:
  /v1/leads:
    post:
      tags:
        - v1
      summary: >-
        Create a lead (callback, quote, finance, insurance) with the buyer's
        consent
      description: >-
        Create a lead for a dealer (callback, quote, finance or insurance) with
        the buyer's explicit consent; your key's prefix is recorded as the
        source.
      operationId: identity_api_v1_leads
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LeadIn'
        required: true
      responses:
        '200':
          description: OK
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LeadOut'
          description: Created
components:
  schemas:
    LeadIn:
      properties:
        buyer_name:
          title: Buyer Name
          type: string
        buyer_phone:
          title: Buyer Phone
          type: string
        buyer_pin:
          anyOf:
            - type: string
            - type: 'null'
          title: Buyer Pin
        consent:
          title: Consent
          type: boolean
        dealer_id:
          anyOf:
            - type: integer
            - type: 'null'
          title: Dealer Id
        intent:
          default: exploring
          title: Intent
          type: string
        kind:
          default: callback
          title: Kind
          type: string
        locale:
          default: en
          title: Locale
          type: string
        location_id:
          anyOf:
            - type: integer
            - type: 'null'
          title: Location Id
        notes:
          anyOf:
            - type: string
            - type: 'null'
          title: Notes
        vehicle_ref:
          anyOf:
            - type: string
            - type: 'null'
          title: Vehicle Ref
        wants_finance:
          default: false
          title: Wants Finance
          type: boolean
        wants_insurance:
          default: false
          title: Wants Insurance
          type: boolean
        dealer_slug:
          default: ''
          title: Dealer Slug
          type: string
      required:
        - buyer_name
        - buyer_phone
        - consent
      title: LeadIn
      type: object
    LeadOut:
      properties:
        buyer_phone_masked:
          title: Buyer Phone Masked
          type: string
        created_at:
          format: date-time
          title: Created At
          type: string
        dealer_id:
          anyOf:
            - type: integer
            - type: 'null'
          title: Dealer Id
        dealer_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Dealer Name
        id:
          title: Id
          type: integer
        kind:
          title: Kind
          type: string
        status:
          title: Status
          type: string
        vehicle_ref:
          anyOf:
            - type: string
            - type: 'null'
          title: Vehicle Ref
      required:
        - id
        - kind
        - status
        - buyer_phone_masked
        - created_at
      title: LeadOut
      type: object

````