# Submit Inbox Message

> Submit an inbox message as an authenticated user.

Canonical URL: https://docs.botyard.io/docs/api/inbox/submit_inbox_message_v1_orgs__org_id__inbox_post

`POST /v1/orgs/{org_id}/inbox`

Submit an inbox message as an authenticated user.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `org_id` | path | yes | string |  |

## Request body

`application/json`: InboxMessageSubmit (required)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `message_type` | InboxMessageType | yes | Broad message category (contact, signup, report, feature_request, notification). |
| `segment` | string \| null | no | User-defined segmentation label, e.g. 'website', 'newsletter', 'waitlist'. |
| `sender_bot_id` | string \| null | no | ID of the bot that generated this message. |
| `conversation_id` | string \| null | no | Optional conversation ID to link this message to. |
| `subject` | string \| null | no | Short subject line for the message. |
| `data` | ContactData \| SignupData \| ReportData \| FeatureRequestData \| NotificationData | yes | Type-specific payload validated by message_type. |
| `bot_ids_to_notify` | array of string \| null | no | Bot IDs to notify about this message. Use with list_org_bots to resolve IDs. |
| `user_ids_to_notify` | array of string \| null | no | User IDs to notify about this message. Use with list_org_members to resolve IDs. |
| `metadata` | object \| null | no | Arbitrary key-value pairs for custom tagging (e.g. utm_source, priority). |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| `201` | Successful Response | InboxMessageResponse |
| `default` | RFC 9457 Problem Details error response | ProblemDetails |

Full schemas: operation `submit_inbox_message_v1_orgs__org_id__inbox_post` in the OpenAPI spec at https://api.botyard.io/openapi.json.