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

# Enable a disabled webhook endpoint

> Starts deliveries again. Events from while it was disabled are not sent. Needs a paid plan.



## OpenAPI

````yaml /openapi.json post /v1/webhooks/{id}/enable
openapi: 3.1.0
info:
  title: LeadVector API
  version: '1'
  description: >-
    Find and verify business emails and mobile numbers, enrich people and
    companies, and run your email campaigns, mailboxes and inbox. Send your API
    key in the `x-api-key` header.
servers:
  - url: https://prod.leadvector.app
    description: Production
security:
  - access-key: []
tags:
  - name: Authentication
    description: Check that an API key works.
  - name: Lookups
    description: >-
      Find business emails and mobile numbers, verify emails, and find the
      person behind an email.
  - name: Enrichment
    description: The full profile of a person or a company.
  - name: Campaigns
    description: Email campaigns and their sequences.
  - name: Leads
    description: A campaign's leads.
  - name: Email accounts
    description: The mailboxes campaigns send from, and their warmup.
  - name: Inbox
    description: Replies to your campaigns, in one inbox.
  - name: Webhooks
    description: Subscribe URLs to events, and read the events sent.
  - name: Campaign events
    description: >-
      A campaign's lifecycle: created, launched, paused, resumed, stopped,
      completed, deleted.
  - name: Lead events
    description: A lead joining a campaign, replying, being labelled, finishing or failing.
  - name: Email events
    description: Each step's email to a lead, sent or failed.
  - name: Inbox events
    description: Mail the inbox receives, and the replies and forwards sent from it.
  - name: Email account events
    description: A mailbox's connection, pause, cooldown, warmup health and deletion.
  - name: Lookup events
    description: >-
      A single lookup’s result, in the app, the extension or the API: an email
      or a mobile found, an email verified, a person or a company enriched.
  - name: Bulk job events
    description: A bulk job (a file of lookups) completing or failing.
  - name: List events
    description: A contact saved to one of the team’s lists.
  - name: Credit events
    description: The team’s credits running low, or out.
  - name: Test event
    description: The event an endpoint gets when you send it a test.
paths:
  /v1/webhooks/{id}/enable:
    post:
      tags:
        - Webhooks
      summary: Enable a disabled webhook endpoint
      description: >-
        Starts deliveries again. Events from while it was disabled are not sent.
        Needs a paid plan.
      operationId: ApiV1WebhooksController_enable
      parameters:
        - name: id
          required: true
          in: path
          description: The endpoint id (whe_…).
          schema:
            type: string
            example: whe_0192b5c4e7a87c3e9d1f2a6b4c8e0d13
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookEndpointResponseDto'
        '401':
          description: API_KEY_REQUIRED / INVALID_API_KEY
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponseDto'
        '403':
          description: >-
            PAID_PLAN_REQUIRED / AMBIGUOUS_TEAM_MEMBERSHIP (a member of several
            teams who owns none) / INSUFFICIENT_TEAM_PERMISSION (the team owner,
            or a member with team management, manages webhooks) /
            ACCOUNT_DEACTIVATED / TEAM_DEACTIVATED
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponseDto'
        '404':
          description: 'WEBHOOK_NOT_FOUND: no endpoint of the team has this id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponseDto'
        '429':
          description: RATE_LIMIT_EXCEEDED, with a Retry-After header
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitErrorResponseDto'
        '503':
          description: >-
            WEBHOOKS_NOT_CONFIGURED: webhooks are not available on this server
            yet
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponseDto'
      security:
        - access-key: []
components:
  schemas:
    WebhookEndpointResponseDto:
      type: object
      properties:
        success:
          type: boolean
          example: true
        message:
          type: string
          example: WEBHOOK_FETCHED
        data:
          $ref: '#/components/schemas/WebhookEndpointViewDto'
      required:
        - success
        - message
        - data
    ApiErrorResponseDto:
      type: object
      properties:
        statusCode:
          type: number
          example: 401
        message:
          description: >-
            A code in capitals; the list of messages when the body fails
            validation; `Internal server error` for a 500.
          oneOf:
            - type: string
            - type: array
              items:
                type: string
          example: INVALID_API_KEY
        error:
          type: string
          description: The status's name.
          example: Unauthorized
        traceId:
          type: string
          description: Quote it when you contact support.
          example: 4f1c2b7e9a0d4c3b8e6f5a2d1c0b9e8f
        timestamp:
          type: string
          example: '2026-11-03T09:41:12.000Z'
        path:
          type: string
          example: /v1/find-email
      required:
        - statusCode
        - message
        - traceId
        - timestamp
        - path
    RateLimitErrorResponseDto:
      type: object
      properties:
        statusCode:
          type: number
          example: 401
        message:
          description: The error's code.
          oneOf:
            - type: string
            - type: array
              items:
                type: string
          example: RATE_LIMIT_EXCEEDED
        error:
          type: string
          description: The status's name.
          example: Unauthorized
        traceId:
          type: string
          description: Quote it when you contact support.
          example: 4f1c2b7e9a0d4c3b8e6f5a2d1c0b9e8f
        timestamp:
          type: string
          example: '2026-11-03T09:41:12.000Z'
        path:
          type: string
          example: /v1/find-email
        limit:
          type: number
          description: Calls allowed per window.
          example: 10
        windowSeconds:
          type: number
          example: 60
        retryAfterSeconds:
          type: number
          description: Seconds until the next call is allowed.
          example: 6
      required:
        - statusCode
        - message
        - traceId
        - timestamp
        - path
        - limit
        - windowSeconds
        - retryAfterSeconds
    WebhookEndpointViewDto:
      type: object
      properties:
        id:
          type: string
          example: whe_0192b5c4e7a87c3e9d1f2a6b4c8e0d13
        url:
          type: string
          example: https://hooks.example.com/leadvector
        description:
          example: Replies to our CRM
          type:
            - string
            - 'null'
        eventTypes:
          example:
            - lead.replied
          description: The event types it receives; `*` for every type.
          type: array
          items:
            type: string
        filters:
          $ref: '#/components/schemas/WebhookFiltersViewDto'
        status:
          type: string
          enum:
            - active
            - disabled
          example: active
        disabledReason:
          enum:
            - by_user
            - receiver_gone
            - failing
            - account_deactivated
            - null
          example: null
          description: >-
            Why it is disabled: by its team, its receiver answered 410, every
            delivery failed for five days, or its account was deactivated.
          type:
            - string
            - 'null'
        apiVersion:
          type: string
          example: 2026-11
          description: The payload version its deliveries are pinned to.
        previousSecretExpiresAt:
          format: date-time
          description: >-
            While a rotation's old secret still signs beside the new one, when
            it stops.
          type:
            - string
            - 'null'
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
      required:
        - id
        - url
        - description
        - eventTypes
        - filters
        - status
        - disabledReason
        - apiVersion
        - previousSecretExpiresAt
        - createdAt
        - updatedAt
    WebhookFiltersViewDto:
      type: object
      properties:
        campaignIds:
          description: Only events about these campaigns of the team's.
          type: array
          items:
            type: string
            format: uuid
  securitySchemes:
    access-key:
      type: apiKey
      in: header
      name: x-api-key
      description: Your API key, from the API keys page of the app.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.