How do i add a @mention to an engagement note



When creating a NOTE via the engagement endpoint, is it possible to add a mention to the note so the mentioned person receives an email?

I’d like to create a NOTE by posting to and have a mention in the note text.

Can i do this somehow?

He’re are some of the variations i’ve tried to get it to work:

Request body

	"engagement": {
        "active": true,
        "ownerId": 11111111,
        "type": "NOTE"
    "associations": {
        "contactIds": [22222222],
        "companyIds": [],
        "ownerIds": [11111111]
	"metadata": {
	    "SEE BELOW"

Reference ID:
"body": "Hi @22222222, here's a message for you"

Reference email:
"body": "Hi, here's a message for you"

Nasty HTML - UI looks right but probably totally wrong :slight_smile: :
"body": "Hi <span data-at-mention="" data-owner-id="2222222">Martin Nielsen</span>, here's a message for you"

My NOTE is created but any attempt to mention someone is just parsed as plain text

Any advice is appreciated.


Hi @martin-nielsen

Currently the emails sent from a mention is something that’s only supported when creating the note in the UI. Having the data-at-mention="" attribute in the HTML of the body will highlight the name, but we don’t have a way to trigger the email through the API right now.


Hi David,

Is this something that is on the roadmap, or is there another way i can trigger an email to an Owner?