---
title: "Send survey by email"
method: POST
path: "/api/v1/surveys/{survey_token}/email"
tags: ["Surveys"]
---

# Send survey by email

`POST /api/v1/surveys/{survey_token}/email`

## Request

- Base URL: `https://api.simplesat.io`
- URL: `https://api.simplesat.io/api/v1/surveys/{survey_token}/email`
- Auth: API key in header `X-Simplesat-Token`

Send a survey email.

Only survey tokens of surveys with survey type `event_based_email` are accepted.

Required scopes: `write surveys`

## Path parameters

- `survey_token` string, required

## Request body

- object
  - `customer` object
    - `id` string
    - `email` string, required
    - `name` string
    - `company` string
    - `language` string
    - `custom_attributes` object
  - `team_member` object
    - `id` string
    - `email` string
    - `name` string
    - `custom_attributes` object
  - `ticket` object
    - `id` string
    - `subject` string
    - `custom_attributes` object

## Response `200`

Successful response

- object
  - `detail` string

## Other responses

- `400`: Bad request
- `404`: Not found

---

[API](https://skmtc.dev/simplesat/apis/simplesat-api-v1.md) · [All operations](https://skmtc.dev/simplesat/apis/simplesat-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/simplesat/apis/simplesat-api-v1/revisions/1c245425416b?raw)