---
title: "Create a test record (manual sessions)"
method: POST
path: "/v1/tests"
tags: ["Tests"]
---

# Create a test record (manual sessions)

`POST /v1/tests`

Creates a TestCase record from outside the WebDriver/Appium flow. Mainly used by clients that want to log a manual or external test result against their TestingBot account. Most users will not need this — the normal flow is to start a Selenium/Appium session, and the record is created automatically.

## Request body

- PostV1Tests — Create a test record (manual sessions)
  - `test` object, required — Test attributes.
    - `name` string, required — Test name.
    - `test_environment_id` integer, required — Browser environment the result is attributed to (`browser_id` from GET /v1/browsers).
    - `success` boolean — true=pass, false=fail.
    - `status_message` string — Failure reason or status string.
    - `extra` string — Arbitrary metadata.
    - `build` string — Build identifier.

## Response `201`

Create a test record (manual sessions)

- TestingbotEntitiesTestCreateAck — Testingbot_Entities_TestCreateAck model
  - `success` boolean, required — Whether the test was created.
  - `test` object, required — The created test record. Only present when `success` is true.
  - `errors` object, required — Validation errors keyed by field name. Only present when `success` is false.

## Other responses

- `400` — Validation error
- `401` — Authentication required
- `403` — Account is read-only

---

[API](https://skmtc.net/testingbot/apis/testingbot-rest-api.md) · [All operations](https://skmtc.net/testingbot/apis/testingbot-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/testingbot/testingbot-rest-api/versions/eff607a49246/schema)