---
title: "Create Accessibility Test"
method: POST
path: "/v1/inspect/accessibility"
tags: ["Accessibility"]
---

# Create Accessibility Test

`POST /v1/inspect/accessibility`

## Request

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

This endpoint allows users to submit an accessibility test for processing. It accepts a set of HTML content, processes it for accessibility issues, and returns a unique job ID for tracking the status of the test.  The status of the job will display in the meta object, with a status of 'Processing'.

## Request body

- POSTV1InspectAccessibilityApplicationJsonRequestBody
  - `html` string, required: The HTML content to be tested. Can be a raw HTML string or base64 encoded.
  - `encoded` boolean: Indicates whether the html content is base64 encoded (true) or raw (false).

## Response `201`

A 201 response

- GithubComMailgunInspectInternalAccessibilityCreateAccessibilityJSONAPIResponse
  - `meta` object, nullable
  - `items` GithubComMailgunInspectInternalAccessibilityCreateAccessibilityResource
    - `id` string, required
    - `links` GithubComMailgunInspectInternalAccessibilitySelfLink
      - `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)