Claim Incentive

Claim a claimable award ("incentive") for yourself in the caller's
company.

Inputs:

  • award_id (string) — the BSON id of the incentive to claim. Use the
    listAwards tool with type: "claimable" to discover incentives.
  • award_name (string) — alternative to award_id: the incentive's
    exact name (case-insensitive). If award_id is given it wins.
  • claim_reason (string, optional) — a note explaining the claim
    (shown to approvers).
  • privacy (string, optional) — one of publicly_visible, privately_visible, immediate_team.
    Only honored when the incentive allows changing privacy.

Claiming creates an approval request. Auto-approved incentives return
the created bonus immediately; incentives with an approval process
return a pending approval_request and bonus: null.

Proof attachments are not supported over MCP. If an incentive requires
proof, claim it through the web app so you can attach the artifact.

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