Hey @nedrybot - thanks for your post.
I’m sorry that you’ve found the documentation difficult to use in this case. I’m going to see if I can clarify, based on your feedback. Essentially, as you’ve found, you get DMs in the user stream, and the point of the doc was to link back to the REST API where the structure of a DM is defined. It isn’t entirely clear from the docs though, so I apologise for that.
Ahhh - sorry about that - it’s a leftover from an older version of our developer forums, which should have been converted to a link. Unfortunately I don’t know which topic node: 4088 refers to anymore, but either way, it appears to have been from a much earlier version of the API.
Finally - thank you so much for sharing your solution! That is sure to be useful for others in the future! 