Give Award

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 / showAward tools to discover awards and their ids.
  • award_name (string) — alternative to award_id: the award's
    exact name (case-insensitive). If award_id is 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
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
enum
required
Allowed:
string
enum
required
Allowed:
params
object
required
string
required
Responses

401

Unauthorized

403

Forbidden

Language
Credentials
Bearer
OAuth2 access token
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json