---
title: "Write to the support team"
method: POST
path: "/support/messages"
tags: ["Support"]
---

# Write to the support team

`POST /support/messages`

## Request

- Base URL: `https://api.epovest.com/v1`
- URL: `https://api.epovest.com/v1/support/messages`
- Auth: HTTP bearer

Reaches the humans behind Epovest: report a problem, suggest an improvement, ask a question.
Use it when a call refuses what should work, when something the user needs is missing, or
when the user asks you to tell us something. We read every message, and early feedback shapes
what gets built. The answer comes back in the same thread: read it with `GET
/support/threads/{id}` and relay it to the user. Threads are shared with the members of the
account, and a message written by an integration is signed as such. Sending is capped at ten
messages per day per credential.

## Request body

- object
  - `message` string, required: What you want to tell us. Include what you tried and what happened.
  - `subject` string: Title of the thread. Derived from the message when omitted; ignored when replying.
  - `kind` 'problem' | 'suggestion' | 'question'
  - `thread_id` string, uuid: Reply to this thread instead of opening a new one.

## Response `200`

The message was sent, and the thread it landed in.

- object
  - `sent` true, required
  - `thread_id` string, nullable, required

## Other responses

- `400`: `bad_request`: malformed body or parameter; the message says what.
- `401`: `unauthenticated`: missing, unknown or revoked key.
- `403`: `insufficient_scope`: the credential may not do this, either because the key lacks the scope, or, on a one-click connection, because the person lacks the role the action needs (manager, or owner to start, pause and top up). On that path, read it as "this person may not do this" and tell them which role the action needs.
- `404`: `not_found`: unknown for this account.
- `429`: `rate_limited`: 120 requests per minute per credential, sliding window. Retry after `Retry-After` seconds.
- `503`: `service_unavailable`: a backend is unreachable; retry later.

---

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