---
title: "POST /api/v0/tests"
method: POST
path: "/api/v0/tests"
tags: ["TestLocally"]
---

# POST /api/v0/tests

`POST /api/v0/tests`

Creates new test

## Request body

- NewTestRequestInput
  - `target` string, required
  - `browser` 'chromium' | 'chrome' | 'firefox' | 'msedge' | 'webkit', nullable
  - `viewport` 'desktop' | 'tablet' | 'phone', nullable
  - `servers` string[], required
  - `headers` object
  - `skipCompression` boolean
  - `ignoreSslErrors` boolean
  - `clicks` string[]

## Response `201`

Test successfully created

- NewTestResponseOutput
  - `id` string
  - `limits` LimitOutput
    - `limits` PlanOutput
      - `tests` integer, nullable
      - `shots` integer, nullable
      - `overageRate` number, float, nullable
      - `maxSchedules` integer, nullable
    - `usage` UsageOutput
      - `tests` integer
      - `shots` integer
      - `unusualActivity` boolean

## Other responses

- `400` — Invalid request
- `403` — Invalid target
- `429` — Account test limit exceeded

---

[API](https://skmtc.dev/testlocal/apis/testlocally.md) · [All operations](https://skmtc.dev/testlocal/apis/testlocally/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/testlocal/testlocally/revisions/f6ef68f805e6/schema)