post
https://bonus.ly/mcp##giveAward
Give a custom award to one or more recipients in the caller's company.
Inputs:
award_id(string) — the BSON id of the award to give. Use the
listAwards/showAwardtools to discover awards and their ids.award_name(string) — alternative toaward_id: the award's
exact name (case-insensitive). Ifaward_idis given it wins.recipients(array of strings) — each entry is a user id, email
address, or display name. No need to format@mentions.message(string, optional) — recognition message. Only used when
the award allows editing its reason; ignored otherwise.amount(integer, optional) — points. Only used when the award
allows changing the amount; ignored otherwise.privacy(string, optional) — one of publicly_visible, privately_visible, immediate_team.
Only honored when the award allows changing privacy.hide_giver(boolean, optional).
Giving an award creates an approval request. Auto-approved awards
return the created bonus immediately; awards with an approval
process return a pending approval_request and bonus: null.
When a required input is missing or a recipient cannot be resolved,
the response either carries a requestedSchema (for clients that
declared elicitation at initialize) or a standard INVALID_PARAMS
error. File attachments are not supported over MCP.
Required OAuth scope: recognition:write
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
401Unauthorized
403Forbidden