---
title: "Capture Channel Message Reference"
method: POST
path: "/channels/message-references"
tags: ["channels"]
---

# Capture Channel Message Reference

`POST /channels/message-references`

Capture ``platform_message_id -> share_id`` after a bridge sends.

## Headers

- `X-WhatsApp-Bridge-Token` string, nullable

## Request body

- ChannelMessageReferenceCaptureRequest — Bind one outbound platform message id to route identity.
  - `user_id` string, required
  - `channel` 'whatsapp' | 'heylo', required — Messaging channel discriminator on the generic channel-associations core. One value per integrated bridge. Adding a channel = new enum value + new :class:`cheshire.channels.bridge.BridgeClient` impl + new thin webhook route. No new backend tables — every channel reuses ``channel_associations`` / ``channel_association_requests``.
  - `platform_message_id` string, required
  - `board_message_id` string, nullable
  - `route_session_id` string, nullable
  - `share_id` string, nullable
  - `source_route_page_id` string, nullable

## Response `200`

Successful Response

- ChannelMessageReferenceCaptureResponse — Stored route reference binding.
  - `id` string, required
  - `user_id` string, required
  - `channel` 'whatsapp' | 'heylo', required — Messaging channel discriminator on the generic channel-associations core. One value per integrated bridge. Adding a channel = new enum value + new :class:`cheshire.channels.bridge.BridgeClient` impl + new thin webhook route. No new backend tables — every channel reuses ``channel_associations`` / ``channel_association_requests``.
  - `platform_message_id` string, required
  - `board_message_id` string, nullable
  - `route_session_id` string, nullable
  - `share_id` string, nullable
  - `source_route_page_id` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/imperfect/apis/imperfect-api.md) · [All operations](https://skmtc.dev/imperfect/apis/imperfect-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/imperfect/imperfect-api/revisions/cc2293a44257/schema)