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

# Delete a webhook endpoint

> Permanently removes the webhook endpoint and all its event subscriptions.



## OpenAPI

````yaml https://apix.spotzee.com/api/openapi.json delete /webhooks/{endpointId}
openapi: 3.1.0
info:
  title: Spotzee API
  version: '2026-04-28'
  description: >-
    Programmatic access to Spotzee. Use this API to manage users, lists,
    segments, campaigns, journeys, templates, and events from your own systems.
  contact:
    name: Spotzee Support
    url: https://docs.spotzee.com
  license:
    name: Proprietary
    url: https://docs.spotzee.com/
servers:
  - url: https://apix.spotzee.com/api
    description: >-
      Public unauthenticated surface — used for form-token submissions and other
      token-scoped callbacks.
  - url: https://apix.spotzee.com/api/client
    description: >-
      Project-scoped surface — use with `sk_` (secret) or `pk_` (publishable)
      API keys.
  - url: https://apix.spotzee.com/api/admin
    description: >-
      Organisation-scoped surface — use with `ok_` API keys for cross-project
      administration.
security: []
tags:
  - name: Projects
    description: >-
      The project the calling key belongs to. Read-only on the project surface —
      use organisation-level keys for project lifecycle.
  - name: Users
    description: >-
      People you message. Identify each one by your own `external_id`; attach
      any custom attributes you want to segment on.
  - name: Events
    description: >-
      Behavioural signals from your application. Drive trigger campaigns and
      journeys, enrich segments, and personalise message content.
  - name: Form submissions
    description: >-
      Token-scoped website form submissions. Use generated form URLs for
      browser-safe opt-ins without exposing secret API keys.
  - name: Lists
    description: >-
      Static and dynamic groups of users. Static lists are explicit memberships;
      dynamic lists evaluate their current membership rule when queried.
  - name: Subscriptions
    description: >-
      Channel-level opt-in state per user. Each subscription type maps to a
      channel (email, push, SMS, webhook, in-app).
  - name: Templates
    description: >-
      Channel-specific message bodies with Handlebars personalisation. Preview,
      proof, and version each template independently.
  - name: Campaigns
    description: >-
      One-off `blast` sends and per-user `trigger` sends. Each campaign targets
      one channel and one subscription type.
  - name: CRM
    description: >-
      Customer relationship records for contacts, companies, pipeline stages,
      activities, and saved views within the calling project.
  - name: Source Sync
    description: >-
      Sync contacts, companies, source-managed CRM properties, and company
      memberships from your own backend systems into the calling project.
  - name: Journeys
    description: >-
      Multi-step automation flows triggered by events, list memberships, or
      campaign sends. Branch on attributes, wait between steps, and send across
      channels.
  - name: Tags
    description: >-
      Free-form labels you can attach to campaigns, journeys, lists, and
      templates for organisation and bulk filtering.
  - name: API keys
    description: >-
      Project-scoped credentials. Create, list, and revoke `sk_` and `pk_` keys
      for the project the calling key belongs to.
  - name: Organisation
    description: >-
      Organisation-scoped operations. Use with `ok_` keys to manage projects
      across an organisation, including the org-level API key catalogue.
  - name: Webhooks
    description: >-
      Outgoing event delivery. Configure HTTPS endpoints, choose events, and
      verify inbound deliveries with the `Spotzee-Signature` HMAC header.
paths:
  /webhooks/{endpointId}:
    delete:
      tags:
        - Webhooks
      summary: Delete a webhook endpoint
      description: >-
        Permanently removes the webhook endpoint and all its event
        subscriptions.
      operationId: deleteWebhookEndpoint
      parameters:
        - schema:
            type:
              - integer
              - 'null'
            description: Numeric webhook endpoint identifier.
            example: 17
          required: false
          description: Numeric webhook endpoint identifier.
          name: endpointId
          in: path
      responses:
        '204':
          description: The endpoint was deleted. No content returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookEndpoint'
        '400':
          description: Malformed request — bad parameters, body, or version header.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Authentication required or the supplied API key is invalid.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: >-
            Authenticated, but the credential lacks scope or role for this
            resource.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: >-
            The referenced resource does not exist or is not visible to this
            key.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: Conflict — duplicate resource or idempotency-key body mismatch.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: >-
            Request was syntactically valid but semantically rejected (failed
            validation).
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Rate-limit bucket exhausted. Honour `Retry-After`.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Unhandled server error. `request_id` should be reported to support.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - projectApiKey: []
      servers:
        - url: https://apix.spotzee.com/api/client
components:
  schemas:
    WebhookEndpoint:
      type: object
      properties:
        id:
          type: integer
          description: Numeric webhook endpoint identifier.
          example: 17
        project_id:
          type: integer
          description: Identifier of the owning project.
          example: 42
        name:
          type: string
          description: Human-readable name shown in dashboards.
          example: Order events to billing service
        description:
          type:
            - string
            - 'null'
          description: Optional free-text note describing the endpoint.
        url:
          type: string
          format: uri
          description: HTTPS URL the signed event payload will be POSTed to.
          example: https://api.example.com/spotzee/webhooks
        status:
          $ref: '#/components/schemas/WebhookStatus'
        event_types:
          type: array
          items:
            $ref: '#/components/schemas/WebhookEventType'
          description: Events the endpoint is subscribed to.
          example:
            - delivery.delivered
            - delivery.failed
        has_secret:
          type: boolean
          description: >-
            Whether a signing secret is currently configured. The plaintext
            secret itself is only returned on create and on rotate — never
            re-fetched.
        created_at:
          type:
            - string
            - 'null'
          description: Time the endpoint was created. ISO 8601.
        updated_at:
          type:
            - string
            - 'null'
          description: Time the endpoint was last modified. ISO 8601.
      required:
        - id
        - project_id
        - name
        - url
        - status
        - event_types
        - has_secret
        - created_at
        - updated_at
      description: >-
        Configured destination that receives signed event payloads when
        subscribed events fire. Verify each delivery using the
        `Spotzee-Signature` header — `t=<unix-ts>,v1=<hex-hmac-sha256>` — with
        HMAC-SHA-256 over `"<unix-ts>.<raw-request-body>"` keyed by the signing
        secret. Reject signatures whose timestamp is more than 5 minutes from
        now.
    ErrorResponse:
      type: object
      properties:
        status:
          type: string
          enum:
            - error
          description: Constant marker indicating this payload is an error response.
        code:
          $ref: '#/components/schemas/ErrorCode'
        title:
          type: string
          description: Short, human-readable summary suitable for a heading. en-AU.
          example: Resource missing
        message:
          type: string
          description: Human-readable, en-AU explanation. May include identifiers.
          example: User usr_01HXY7Z9K8M5J2N4P6Q8R0S1T2 was not found in this project.
        error:
          type: string
          description: >-
            Legacy human-readable mirror of `message`. Retained while in-product
            clients migrate; new integrations should read `message`.
        type:
          type: string
          format: uri
          description: Documentation URL for this error class (RFC 7807).
          example: https://docs.spotzee.com/main-api/errors#resource_missing
        request_id:
          type: string
          description: >-
            Server-generated correlation ID. Echoed in the X-Request-ID response
            header.
          example: req_01HXY7Z9K8M5J2N4P6Q8R0S1T2
        param:
          type: string
          description: Name of the offending parameter, when a single field is at fault.
          example: id
        errors:
          type: array
          items:
            $ref: '#/components/schemas/FieldError'
          description: Field-level errors when multiple parameters fail validation.
      required:
        - status
        - code
        - message
        - error
      description: >-
        Spotzee error envelope (RFC 7807 + Stripe-style extensions). Served as
        `application/problem+json`.
    WebhookStatus:
      type: string
      enum:
        - active
        - inactive
        - disabled
      description: >-
        Lifecycle state of the endpoint. `active` receives events; `inactive` is
        paused by the user; `disabled` was suspended by the system after
        repeated delivery failures.
      example: active
    WebhookEventType:
      type: string
      enum:
        - queue.queue-message-authenticated
        - queue.rescheduled
        - queue.quota-exceeded
        - delivery.concurrency-limit-exceeded
        - delivery.attempt-start
        - delivery.attempt-end
        - delivery.completed
        - delivery.delivered
        - delivery.dsn-perm-fail
        - delivery.dsn-temp-fail
        - delivery.failed
        - delivery.mail-from-rejected
        - delivery.message-rejected
        - delivery.rcpt-to-rejected
        - delivery.rcpt-to-failed
        - delivery.mx-lookup-failed
        - delivery.ip-lookup-failed
        - delivery.null-mx
        - delivery.connect-error
        - delivery.greeting-failed
        - delivery.ehlo-rejected
        - delivery.start-tls-error
        - delivery.start-tls-unavailable
        - delivery.implicit-tls-error
        - incoming-report.abuse-report
        - incoming-report.fraud-report
        - incoming-report.virus-report
      description: >-
        Event the endpoint is subscribed to. Each event identifies a queue,
        delivery, reputation, or infrastructure signal. See the events reference
        for full descriptions.
      example: delivery.delivered
    ErrorCode:
      type: string
      enum:
        - resource_missing
        - resource_already_exists
        - state_conflict
        - archived_user_conflict
        - user_capacity_exhausted
        - parameter_missing
        - parameter_invalid_empty
        - parameter_invalid_format
        - parameter_unknown
        - validation_failed
        - authentication_required
        - permission_denied
        - idempotency_key_mismatch
        - idempotency_key_invalid
        - idempotency_in_progress
        - rate_limited
        - version_unsupported
        - version_required
        - webhook_signature_invalid
        - quota_exceeded
        - service_unavailable
        - internal_error
      description: Stable, machine-readable error code. Safe to switch on; never localised.
      example: resource_missing
    FieldError:
      type: object
      properties:
        param:
          type: string
          description: Dotted path to the offending request field.
          example: email
        code:
          allOf:
            - $ref: '#/components/schemas/ErrorCode'
            - description: Per-field error code.
              example: parameter_invalid_format
        message:
          type: string
          description: Human-readable, English (en-AU) explanation of this field error.
          example: Must be a valid email address.
      required:
        - param
        - code
        - message
  securitySchemes:
    projectApiKey:
      type: http
      scheme: bearer
      description: >-
        Project-scoped secret API key (`sk_…`). Pass in the `Authorization:
        Bearer <key>` header. Grants access to the project the key was issued
        for.

````

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