Create Test

Method creates a new empty test in StartExam.

Request Information

Scheme

POST https://api.startexam.com/v1/create-test

URI Parameters

None

Body Parameters

Json with the CreateTestQuery:

• ProjectId - Project identifier which will be a test container. Projects list can be found in your account details page at app.startexam.com
• Title - name of the test. Max length: 200 symbols
• Type - type of the entity. Supported values: test , survey

Request Example

• Json Request

POST https://api.startexam.com/v1/create-test HTTP/1.1
Host: api.startexam.com
Accept: application/json; charset=utf-8
Authorization: SharedKey 99:f52JP7GQd0xqrBzMO1NWTNVGzLENymgdUXu/Ie++NX4=
Content-Type: application/json; charset=utf-8
Content-Length: 118
Date: Mon, 02 Feb 2026 12:10:55 GMT

{
  "projectId": "580d2596-61e2-4e45-bb4d-3006d5455634",
  "title": "My new Test (created by API)",
  "type": "test"
}

Date and Authorization headers are constructed in the standard way.

Response Information

HTTP status code

200 OK, 400 Bad Request, etc. according the response processing guide.

Content-Type

Json.

Content

Method returns identifier of the created test:

• TestId - ID of the created test.

Response Example

• Json Response

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 54

{
  "testId": "93e1c1b8-a4ae-4f0b-9487-a33d8c94b6ef"
}

Use TestId as a URL parameter to redirect user to the Test Settings page:
https://app.startexam.com/Test/Settings?testId=93e1c1b8-a4ae-4f0b-9487-a33d8c94b6ef

Try Method