Skip to content

Messaging

The messaging surface posts to the server's message channel to send a message addressed to one or more recipients (tags, users, or device uids, depending on what your deployment routes via messaging). The SDK exposes one method that mirrors the wire shape.

Operations

Method What it does
client.messaging.send(*, from_uid, to_uids, body) Post a message to /api/v2/messaging.
client.messaging.send(
    from_uid=client.users.me().uid,
    to_uids=["u-1", "u-2"],
    body="ping",
)

from_uid, to_uids, and body are all required. Returns the server's response payload as a dict; raises the standard typed exceptions on failure.

See also

  • Error handling — typed exceptions for message failures.
  • Discrepancy #15/api/v2/messaging replaces the deprecated /api/v2/win_message_que/create.json path the JS reference client uses.