List linked channels

GET/v1/channels

Lists the channel identities linked to your brand. An empty list means nothing is linked yet.

ReturnsExpand Collapse

channels: array of ChannelBinding { business_id, channel, created_at, 2 more }

Always an array; [] when nothing is linked yet, never null.

business_id: string

The linked business id: a UUID issued at business registration.

channel: "amb"

The messaging channel. amb is the only channel this API serves today.

created_at: string

formatdate-time

entry_point_url: string

The Messages entry deep link for this binding (https://bcrw.apple.com/urn:biz:<business_id>); open it from an approved tester device to start a chat with the business and verify the link end to end. DERIVED from business_id, not stored: the URL format is platform knowledge, served here so no client composes it by hand.

origin: "seed" or "connect" or "control"

Where the link came from: connect is a self-service link (the Connect landing page, or POST /v1/channels: the same self-service path over this API), seed is boot configuration, control was provisioned by Linq. Provenance only; all three behave identically.

One of the following:

"seed"

"connect"

"control"

List linked channels

curl https://messages.api.linqapp.com/v1/channels \
    -H "Authorization: Bearer $LINQ_AMB_API_KEY"

{
  "channels": [
    {
      "channel": "amb",
      "business_id": "a884eddf-b0ad-4be4-9c0e-071531638768",
      "origin": "connect",
      "entry_point_url": "https://bcrw.apple.com/urn:biz:a884eddf-b0ad-4be4-9c0e-071531638768",
      "created_at": "2026-08-01T12:00:00Z"
    }
  ]
}

Returns Examples

{
  "channels": [
    {
      "channel": "amb",
      "business_id": "a884eddf-b0ad-4be4-9c0e-071531638768",
      "origin": "connect",
      "entry_point_url": "https://bcrw.apple.com/urn:biz:a884eddf-b0ad-4be4-9c0e-071531638768",
      "created_at": "2026-08-01T12:00:00Z"
    }
  ]
}