---
title: "Create a Link Validation Test"
method: POST
path: "/v1/inspect/links"
tags: ["Link Validation"]
---

# Create a Link Validation Test

`POST /v1/inspect/links`

## Request

- Base URL: `https://api.mailgun.net`
- URL: `https://api.mailgun.net/v1/inspect/links`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/mailgun/apis/email-preview-api/docs/v1/inspect/links/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a link validation test.

## Request body

- GithubComMailgunInspectInternalLinkvalidationLinkValidationRequest
  - `links` string[]
  - `linksWithPositions` GithubComMailgunInspectInternalLinkvalidationLink[]
    - `url` string, required
    - `line` integer
    - `column` integer
    - `selector` string
    - `absolute_index` integer
  - `userAgent` string, nullable, required

## Response `200`

A 200 response

- GithubComMailgunInspectInternalLinkvalidationCreateLinkValidationJSONAPIResponse
  - `meta` object, nullable
  - `items` GithubComMailgunInspectInternalLinkvalidationCreateResource
    - `id` string, required
    - `links` GithubComMailgunInspectInternalLinkvalidationSelfLink
      - `self` string, required

## Other responses

- `400`: A 400 response
- `401`: A 401 response

---

[API](https://skmtc.dev/mailgun/apis/email-preview-api.md) - [All operations](https://skmtc.dev/mailgun/apis/email-preview-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mailgun/apis/email-preview-api/revisions/c8a18f02bc8b?raw)