---
title: "Create employee survey"
method: POST
path: "/surveys"
tags: ["Surveys"]
---

# Create employee survey

`POST /surveys`

## Request

- Base URL: `https://verifyref.com/api/v1`
- URL: `https://verifyref.com/api/v1/surveys`
- Auth: HTTP bearer

## Request body

- CreateSurveyRequest
  - `title` string, required
  - `description` string
  - `anonymous` boolean
  - `recipients` object[], required
    - `email` string, required
    - `name` string
  - `questions` Question[], required
    - `text` string, required
    - `type` 'TEXT' | 'TEXTAREA' | 'RATING' | 'MULTIPLE_CHOICE' | 'YES_NO', required
    - `required` boolean
    - `order` number, required
    - `options` string: Required for MULTIPLE_CHOICE (serialized choices)

## Response `201`

Survey created

---

[API](https://skmtc.dev/verifyref/apis/verifyref-api.md) · [All operations](https://skmtc.dev/verifyref/apis/verifyref-api/llms.txt) · [OpenAPI document](https://skmtc.dev/verifyref/apis/verifyref-api/revisions/28eea5e6525b?raw)