---
title: "Sends a portal message"
method: POST
path: "/matters/{matterId}/portal/messages"
tags: ["Portal"]
---

# Sends a portal message

`POST /matters/{matterId}/portal/messages`

Sends a message to the specified contact on the client portal. 

When using the Client Credentials grant type, include the UserId header to impersonate
the lawyer in the firm who is sending the message.

## Path parameters

- `matterId` string, uuid, required

## Request body

- PortalMessageDto
  - `contactId` string, uuid — Unique identifier of the contact.
  - `message` string, required
  - `requireMFA` boolean — Whether MFA is required before showing the message content.

## Response `202`

When request is accepted.

## Other responses

- `400` — When an unsupported request is made.
- `403` — When the authenticated account does not have access to the matter.
- `404` — When matter with specified id does not exist.

---

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