Using mentions with the API
Mauricio Breña
The ability to include mentions in comment text or task descriptions
Log In
Thibaut
Hey, I needed this and docs vs experience wasn't conclusive, so I tested a few permutations. What I found testing this with Claude (July 2026):
- Task comments — individual @mention works. The documented {"type": "tag", "user": {"id": ...}} segment in the comment array does fire a real notification — but only when posted by a different account than the one being tagged. ClickUp silently suppresses self-notifications, which is likely why many reports here call this broken — most people testing it are tagging themselves with their own token.
- Task comments — group/team @mention does not work. Same format with {"type": "tag", "group": {"id": ...}} is accepted with no error, but silently no-ops — no tag relationship is created, unlike the individual case.
- Chat messages — no @mention support at all. content must be a plain string; there's no structured array format like task comments have (sending one returns a 400). Neither Slack-style (<@id>) nor markdown-link mentions embedded in content register as a tag.
- Chat messages — assignee field works as a workaround for individual pings (fires a real notification), but followers does not, and group_assignee is accepted with no visible confirmation it actually notifies the group.
Ask: real @mention support (individual + group) for both task comments and chat messages via the API, matching what typing @ does in the UI.
Brendan W
Merged in a post:
Enable mentioning users via the API
Daniel Charles
I am using the MCP integration heavily in my daily workflows now. The MCP has a significant amount of functionality, except for the ability to mention a user in a comment or chat. It is frustrating to be able to do 99% of the work via the MCP, but then having to go to the task directly, just to add an @mention
Creating checklists via the MCP would also be highly beneficial as well
Marvin Hübner
We're really need this!
Victor Fateyev
Please, my projects need this functionality. It's not something just API call at the end of the day - with MCPs we can get it more like featured experience, so please add mentioning thru API.
Brenno Vicario Nicolau
I just want to notify everybody about someone's birthday.
Brian Kim
Yes I need this as well!
Lukas Moser
that would be great