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

# Send message to a business

`POST /v1/actions/message-request`

## Request

- Base URL: `https://loppee.com`
- URL: `https://loppee.com/v1/actions/message-request`
- Auth: one of:
  - API key in header `X-LOPPEE-API-Key`
  - HTTP bearer

Send a customer message directly to any eligible published business's Loppee inbox. Messaging is available on every v3 exposure plan; payment never changes messaging access, business class, ranking, or review authority. Repeat sends append to the same conversation, and replies are read through /v1/actions/list-my-conversations.

## Request body

- MessageRequest
  - `account_id` string, required
  - `target_business_id` string, required
  - `target_business_name` string, required
  - `target_business_source` string, required
  - `subject` string, required
  - `message` string, required
  - `client_message_id` string, required: Caller-stable retry key. Exact replay is idempotent; reuse with different content is rejected.

## 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)