> ## 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 a promoter

> You can identify promoters by: `id` , `cust_id` , `auth_token` , `promoter_email` or `ref_id`(referral id). You need to pass at least one of these parameters.<Tip>**HTTP Request** <br/> `DELETE https://firstpromoter.com/api/v1/promoters/delete`</Tip>

You can identify promoters by: **id, promoter\_email,  cust\_id, auth\_token or ref\_id(referral id)**. You need to pass at least one of these parameters.


## OpenAPI

````yaml openapi-promoters DELETE /delete
openapi: 3.0.1
info:
  title: FirstPromoter Promoters API
  description: >-
    The Promoters API endpoint allows you to manage your affiliates/promoters
    through API calls. The most important use case is to automatically create
    promoter accounts for your customers.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://firstpromoter.com/api/v1/promoters
security:
  - apiKeyAuth: []
paths:
  /delete:
    delete:
      description: >-
        You can identify promoters by: `id` , `cust_id` , `auth_token` ,
        `promoter_email` or `ref_id`(referral id). You need to pass at least one
        of these parameters.<Tip>**HTTP Request** <br/> `DELETE
        https://firstpromoter.com/api/v1/promoters/delete`</Tip>
      parameters:
        - name: id
          in: query
          description: The promoter's ID inside FirstPromoter
          schema:
            type: string
        - name: cust_id
          in: query
          description: >-
            Your customer's user ID inside your application/system for the
            promoter.
          schema:
            type: string
        - name: ref_id
          in: query
          description: >-
            Referral ID. If this is blank an ID is assigned based on the first
            name. Can be only `lower-case letters`, `numbers`, `-`(hyphen) and
            `_`(underscore)
          schema:
            type: string
        - name: auth_token
          in: query
          description: Authentication token generated when the promoter was created
          schema:
            type: string
      responses:
        '200':
          description: Show promoters response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
                example:
                  message: Promoter removed.
        '401':
          description: Authentication Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthenticationError'
                example: Bad credentials
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnprocessableEntityErrorType1'
                example:
                  error: Promoter not found.
        '422':
          description: Unprocessable Entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnprocessableEntityErrorType1'
                example:
                  error: >-
                    You need to find the promoter either by id, cust_id,
                    auth_token, ref_id or promoter_email
components:
  schemas:
    MessageResponse:
      required:
        - message
      type: object
      properties:
        message:
          type: string
    AuthenticationError:
      type: string
    UnprocessableEntityErrorType1:
      required:
        - error
      type: object
      properties:
        error:
          type: string
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY

````