← All toolsCommunicationslackAll editions

SLACK_USER_LOOKUP

Look up a Slack user by email or display name. Returns user ID, name, email, status.

Parameters

NameTypeRequiredDescription
emailstringEmail address for exact lookup
namestringDisplay name or real name for fuzzy search

How to use it

You normally trigger this by describing what you want in chat — the agent selects SLACK_USER_LOOKUP automatically. For example:

Try saying
“use slack to slack …”

In a workflow

As a step in a multi-step workflow DAG:

json
{
  "id": "s1",
  "agent": "slack",
  "action": "SLACK_USER_LOOKUP",
  "args": {
    "email": "name@example.com",
    "name": "…"
  },
  "depends_on": [],
  "outputs": []
}

Direct call

For scripting, call it directly via POST /execute_tool. Every tool returns { success, message, data }.

bash
curl -X POST http://127.0.0.1:8000/execute_tool \
  -H "Content-Type: application/json" \
  -d '{"tool_name":"SLACK_USER_LOOKUP","args":{"email":"name@example.com","name":"…"}}'

Part of the slack plugin. Browse the full Plugin & Tool Catalog or the relevant feature guide.