# Refresh health score

Recalculate your health score with the latest data.
Health scores are automatically updated daily, but you can manually refresh when needed.

Endpoint: POST /api/customer/health-score/refresh
Version: 1.0.0
Security: ApiKeyAuth

## Response 200 fields (application/json):

  - `health_score` (object)

  - `health_score.overall_score` (number)
    Overall health score (0-100, higher is better)

  - `health_score.delivery_rate` (number)
    Percentage of emails successfully delivered

  - `health_score.open_rate` (number)
    Percentage of delivered emails opened

  - `health_score.click_rate` (number)
    Percentage of delivered emails clicked

  - `health_score.bounce_rate` (number)
    Percentage of emails bounced

  - `health_score.complaint_rate` (number)
    Percentage of emails marked as spam

  - `health_score.reputation_grade` (string)
    Letter grade representation of health score
    Enum: "A+", "A", "B+", "B", "C+", "C", "D", "F"

  - `health_score.last_calculated` (string)
    When this score was last calculated

  - `insights` (object)

  - `insights.status` (string)

  - `insights.summary` (string)

  - `message` (string)
    Example: "Health score refreshed successfully"

## Response 401 fields (application/json):

  - `error` (string)
    Error code or message

## Response 404 fields (application/json):

  - `error` (string)

  - `message` (string)
    Example: "Send some emails first to generate a health score"