Find Discord member ID by name
TL;DR
About
Discord hides user IDs until you turn on Developer Mode (User Settings > Advanced) and right-click someone to copy theirs. Fine for one person. An agent posting for you has it harder, because a real mention must be written as <@userId>. You pass a name, or the start of one, and the link to a channel in that person's server. The lookup types @name into that channel's message box, reads the IDs off the mention popup and clears the box without sending. Say a moderator's agent is posting the Friday scrim lineup. It passes "marta" with the #general link, gets her ID plus any other Martas in matches, and checks the label before writing <@userId>. A bot can run a similar prefix search on usernames and nicknames through Discord's Search Guild Members endpoint, once someone with Manage Server adds it. The catch is that you must be signed in, and only members of that channel's server show up.
Input
name requiredName (or start of the name) of the member to resolve. Throws when no member matches.
channelUrl requiredURL of a channel in the server to search, e.g. https://discord.com/channels/<guildId>/<channelId>. Must be a channel the signed-in account can type in (the lookup runs through that channel's message box).
Output
userId requireduserId of the first result (best match), or null.
matches requiredAll members offered by the autocomplete, best first.
Example output
Shape only: placeholder values generated from the output schema, not a real run.
{
"userId": "abc123",
"matches": [
{
"label": "Example",
"userId": "abc123"
}
]
}FAQ
Read Discord messages
Reads the most recent messages of a Discord channel or direct message (author, timestamp, text), newest first, scrolling up to load more until the requested count. Requires being logged in. A DM or group DM is read the same way: pass its url from discord.com/list_dms. It also reads a thread or a forum post, since both are channels in their own right: pass the post's url (from discord.com/list_forum_posts) and you get its replies plus the opening post, newest first — there is no separate thread-reading script. To list the posts of a forum channel rather than its messages, use discord.com/list_forum_posts instead.
Post a Discord message
Posts a text message, optionally with a file attached, in a Discord channel addressed by its URL. Requires being logged in to Discord. Returns `sent` plus the created message's messageId, channelId, timestamp and content as Discord stored it. The message is visible to everyone who can see the channel. Empty messages and messages over 2000 characters are refused with a clear reason. Use dry_run to check a channel and message without posting.
Delete Discord message
Deletes a single Discord message by id (e.g. to clean up a message you sent). Requires being logged in as the message's author or having Manage Messages in the channel.