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

# Delete lead/customer

> Remove a lead/customer from FirstPromoter using the API. You can find the referral either by `id` , `uid` or `email`. <Tip>**HTTP Request** <br/>`DELETE https://firstpromoter.com/api/v1/leads/delete`</Tip>



## OpenAPI

````yaml openapi-leads DELETE /delete
openapi: 3.0.1
info:
  title: FirstPromoter Leads API
  description: >-
    The leads API allows you to manage the leads and customers referred by your
    promoters. To send an API call you will require the API key found in the
    `Settings` page to be added in the `x-api-key` header.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://firstpromoter.com/api/v1/leads
security:
  - apiKeyAuth: []
paths:
  /delete:
    delete:
      description: >-
        Remove a lead/customer from FirstPromoter using the API. You can find
        the referral either by `id` , `uid` or `email`. <Tip>**HTTP Request**
        <br/>`DELETE https://firstpromoter.com/api/v1/leads/delete`</Tip>
      parameters:
        - name: id
          in: query
          description: |-
            `required if email or uid is null` 

            ID of the lead or customer to delete
          schema:
            type: string
        - name: uid
          in: query
          description: |-
            `required if email or id is null` 

            UID of the lead or customer to delete
          schema:
            type: string
        - name: email
          in: query
          description: |-
            `required if id and uid is null` 

            Email of the lead or customer to delete
          schema:
            type: string
      responses:
        '200':
          description: delete lead 200 response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '401':
          description: Authentication error 401 response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthenticationError'
                example: Bad credentials
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
                example:
                  error: Lead not found.
        '422':
          description: Unprocessable Entity Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
                example:
                  error: >-
                    You need to find the lead/customer either by id, uid or
                    email.
components:
  schemas:
    MessageResponse:
      required:
        - message
      type: object
      properties:
        message:
          type: string
    AuthenticationError:
      type: string
    NotFoundError:
      type: object
      properties:
        error:
          type: string
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY

````