---
title: "Send a message"
method: POST
path: "/actions/send_message"
tags: ["Actions"]
---

# Send a message

`POST /actions/send_message`

Send a message to a channel or conversation on a connected integration.

## Request body

- SendMessageRequest — Send a message to a channel or conversation.
  - `provider` 'reddit' | 'notion' | 'slack' | 'google_calendar' | 'google_mail' | 'box' | 'dropbox' | 'github' | 'google_drive' | 'vault' | 'web_crawler' | 'trace' | 'microsoft_teams' | 'gmail_actions' | 'granola' | 'fathom' | 'fireflies' | 'linear' | 'hubspot' | 'salesforce' | 'coda' | 'lightfield' | 'gong', required
  - `connection` string, nullable — Connection ID. If omitted, auto-resolved from provider + user.
  - `text` string, required — Message text
  - `channel` string, nullable — Channel ID (required for Slack)
  - `parent` string, nullable — Parent message ID for threading (thread_ts for Slack)

## Response `200`

Successful Response

- ActionResult — Result from executing an integration action.
  - `success` boolean, required
  - `error` string, nullable
  - `provider_response` object, nullable

## Other responses

- `422` — Validation Error

---

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