View as Markdown
Awardco icon

Awardco ACTION

Recognize With Recognition Program

Submit recognition in Awardco, with a recognition program. See the documentation.
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Awardco account once, then configure and run Recognize With Recognition Program from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "awardco-recognize-with-recognition-program",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    awardco: { authProvisionId: "apn_xxxxxxx" },
    recipients: ["Recipients"],
    note: "Note",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Recognize With Recognition Program inputs
Property Type Description
recipients Recipients string[]
Employee IDs, emails, or usernames of people to recognize (at least one)
Required
note Note string
Short note describing why the user(s) are being recognized
Required
tagNames Tag names string[]
Optional tags to attach to the recognition
Required
giver Giver string
Who is giving the recognition; leave empty to use the company recognition bot
Optional
amount Amount integer
Cash value of the recognition in the company base currency (0 if none)
Optional
isPublic Public boolean
Whether the recognition appears as public in the feed
Optional
recognitionProgramId Recognition program ID integer
ID of the recognition program
Optional
recognitionProgramName Recognition program name string
Name of the recognition program
Optional
budgetName Budget name string
Required when amount is greater than 0 and the program uses allowable access budgets; may be ignored for central or recipient-based budgets
Required
title Title string
Optional headline (max 50 characters; only when the program has the title question enabled)
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
awardco-recognize-with-recognition-program
Version
0.0.2
App
Awardco
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes