---
title: "Message a business"
method: POST
path: "/v1/actions/business-message"
tags: ["Moderated Actions"]
---

# Message a business

`POST /v1/actions/business-message`

## Request

- Base URL: `https://loppee.com`
- URL: `https://loppee.com/v1/actions/business-message`
- Auth: HTTP bearer

Send a registered customer message to a business's owner/agent inbox. Requires a Supabase customer bearer token (the sender identity is derived from the token, not the body).

## Request body

- PublicMessageRequest
  - `target_business_id` string, required
  - `target_business_name` string
  - `target_business_source` string
  - `subject` string
  - `message` string, required
  - `source_path` string

## Response `200`

MessageResponse

- MessageResponse
  - `status` 'message_received', required
  - `conversation_id` string, required
  - `interaction_id` string, required
  - `account_id` string, required
  - `target_business_id` string, required
  - `target_business_name` string
  - `created_at` string, required
  - `moderation_required` unknown
  - `delivery` 'delivered_to_business_inbox'
  - `client_message_id` string, required
  - `idempotent_replay` boolean, required

## Other responses

- `400`: ErrorResponse
- `401`: ErrorResponse
- `403`: ErrorResponse
- `429`: RateLimitError
- `default`: ErrorResponse

---

[API](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents.md) · [All operations](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/revisions/37285f7cddcd?raw)