---
title: "Create a List Health Preview Job"
method: POST
path: "/v4/address/validate/preview/{list_id}"
tags: ["List Health Preview"]
---

# Create a List Health Preview Job

`POST /v4/address/validate/preview/{list_id}`

## Request

- Base URL: `https://api.mailgun.net`
- URL: `https://api.mailgun.net/v4/address/validate/preview/{list_id}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/mailgun/apis/validations-service/docs/v4/address/validate/preview/:list_id/post.ts> (a function with typed inputs; its response is checked against the schema)

Start a list health preview job from a list of addresses. We will sample the list and run validations on a small percentage.

## Path parameters

- `list_id` string, required

## Response `202`

A 202 response

- GithubComMailgunValidationsApiPreviewPostResponse
  - `id` string, required
  - `message` string, required

## Other responses

- `default`: A default response

---

[API](https://skmtc.dev/mailgun/apis/validations-service.md) - [All operations](https://skmtc.dev/mailgun/apis/validations-service/llms.txt) - [OpenAPI document](https://skmtc.dev/mailgun/apis/validations-service/revisions/4fa5cebfcf59?raw)