Type: Function
Function: INCLUDE_ME
Syntax: INCLUDE_ME(usernames)
Description: Returns true if the list of usernames contains one of the current user's usernames.
The current user is the person viewing the insight. Through the Keypup API or the MCP server, it is the person the API token or the MCP connection belongs to.
INCLUDE_ME(usernames) is the same as CONTAINS(usernames, ME()): see ME.
It is the same condition as the includes me filter of the insight designer (see Using filters). Use it in a custom formula, to count, group or label records on that condition, or as a filter in a query sent through the Keypup API or MCP server.
Usernames are matched as text. A user's usernames are the ones of the apps they connected to their Keypup account (see Managing app identities), one per app. Someone else with the same username in another app, or with the same display name in an app which identifies people by name, such as Jira or Bitbucket, also matches. A user with no app connected matches nothing. The includes me filter of the insight designer matches the user's accounts exactly: prefer it when building an insight.
Sample usage:
INCLUDE_ME(assignee_usernames)returnstruefor the records assigned to the current user.INCLUDE_ME(assignee_usernames) ? "Mine" : "Others"as a dimension splits the records between those assigned to the current user and the others.