# Receive bounce notifications

Webhook endpoint for receiving bounce notifications from mail servers or monitoring services.
Public endpoint - configure this URL in your mail server or monitoring service.

The system will process the bounce and update email status automatically.

Endpoint: POST /webhooks/bounce
Version: 1.0.0
Security: , 

## Request fields (application/json):

  - `emailId` (string, required)
    ID of the bounced email
    Example: "550e8400-e29b-41d4-a716-446655440000"

  - `bounceType` (string)
    Type of bounce
    Enum: "hard", "soft"

  - `reason` (string)
    Bounce reason or error message
    Example: "550 5.1.1 User unknown"

  - `recipientEmail` (string)
    Recipient that bounced
    Example: "bounced@example.com"

  - `timestamp` (string)
    Example: "2024-03-15T14:30:00Z"

  - `customData` (object)
    Additional bounce metadata

## Response 200 fields (application/json):

  - `success` (boolean)
    Example: true

## Response 400 fields (application/json):

  - `error` (string)
    Example: "emailId is required"

## Response 500 fields (application/json):

  - `error` (string)
    Example: "Failed to process bounce"