Awardco integration
Awardco is an employee recognition and rewards platform. An agent can send recognitions (with or without a recognition program, optionally awarding points from a budget), log external recognitions, upload bulk recognitions and user imports as CSV files, read the social feed and the metadata-filtered custom feed, create, activate and archive users, check that a user exists, read a user's point balance, update profile pictures, and export reports (the synchronous report data route and the asynchronous V2 report queue with its discovery routes). Not exposed: the legacy JSON report routes (sunset on October 14, 2026), the MemoryBooks associations upload (a GET carrying a JSON body) and password reset. Authentication is an API key sent in the apiKey header; Awardco gives keys to approved developers, and each key only reaches the endpoints its permissions allow.
Say what should happen.
The workflow builds itself.
What you can do with Awardco
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
User, 6 operations
activate_userActivate userPOSTActivates an Awardco user (for example one previously archived), identified by employeeId, email or username (give at least one).archive_userArchive userPOSTArchives an Awardco user, identified by employeeId, email or username (give at least one). activate_user activates the user again.check_user_existsCheck user existsPOSTChecks whether a user exists in Awardco (exists true or false), identified by employeeId, email or username (give at least one).create_userCreate userPOSTCreates an Awardco user with an employee ID and legal first and last name; notify=true emails the user about the new account.import_usersImport usersPOSTQueues a user import from a CSV file (creates and updates users). archive is required: True archives every existing user missing from the file (except doNotArchive ids), False archives nobody.list_usersList usersGETLists the company's Awardco users with employee ID, first and last name, email and point balance with its currency.
Recognition, 5 operations
create_recognitionCreate recognitionPOSTSends a recognition through a recognition program to one or more users, optionally awarding an amount from a budget; the program's settings decide limits and notifications. Give recognitionProgramId or recognitionProgramName.create_recognition_without_programCreate recognition without programPOSTSends a recognition to one or more users without a recognition program, optionally awarding an amount from a budget. sendNotifications decides whether recipients are emailed (then emailTemplateName is required).list_custom_feedList custom feedGETLists recognitions whose giver or a recipient matches the metadata filter values given in metadataFilter (the metadata field is set up in Awardco); without it, all public recognitions. Paged by page and limit (max 1000).list_social_feedList social feedPOSTLists the company's recognition social feed one page at a time (page and limit). Each recognition carries its giver, recipients, text, tags, hashtags, reaction count and comments.upload_bulk_recognitionsUpload bulk recognitionsPOSTCreates many recognitions at once from an uploaded CSV file (one row per recognition, amounts drawn from the named budgets). Returns success only; the CSV columns are listed in the file parameter.
Report, 3 operations
get_queued_report_infoGet queued report infoGETLists a V2 report's standard columns, dynamic column categories, filter categories and supported time zones, for building start_report_task. groupByOptions is filled only for report 23 (Recognition Limit Utilization).get_report_infoGet report infoGETLists the data filters and content columns run_report accepts for one report (limit 5 calls per minute). Set includesValues=true to also get every possible value of each filter.run_reportRun reportPOSTReturns a report's records as JSON in one synchronous call (limit 5 calls per minute; 5 rate-limited answers in a minute block the IP for 5 minutes). get_report_info lists its filters and columns; use start_report_task for large exports.
Report task, 2 operations
get_report_task_statusGet report task statusGETReturns a report task's status (in progress, completed, failed, expired); limit 12 calls per minute, so wait between checks. When completed: downloadUrl (valid 10 minutes) or, if paginated, totalPages for get_report_task_page.start_report_taskStart report taskPOSTStarts a background report export and returns its taskId; then call get_report_task_status (at most 12 calls a minute) until status is completed, failed or expired. Limit 5 starts per minute. Needs the Report Api V2 key permission.
Custom feed filter value, 1 operation
list_custom_feed_filter_valuesList custom feed filter valuesGETLists every value of the metadata field used to filter list_custom_feed. Returns nothing if no custom feed metadata filter is set up in Awardco.
Data warehouse, 1 operation
get_data_warehouse_refresh_dateGet data warehouse refresh dateGETReturns when the company's data warehouse was last refreshed; compare it with a report's date range to know whether warehouse-backed data is complete. Needs the api/reports/data-warehouse/last-refreshed-date key permission.
External recognition, 1 operation
create_external_recognitionCreate external recognitionPOSTSubmits an external recognition: userEmail is the user receiving it, note shows on the feed, and externalRecognitionProgramUrl names the external program. toPartyIdentifier (full or partial name) identifies the user when email and URL are empty.
Profile picture, 1 operation
upload_profile_picturesUpload profile picturesPOSTSets the profile picture of up to 50 users per call from base64-encoded images; returns successfulUploads (with image URLs) and failedUploads (with the error).
Report column, 1 operation
list_report_dynamic_columnsList report dynamic columnsGETLists up to 100 selectable dynamic columns of one category of a V2 report (category from get_queued_report_info dynamicColumnCategories). Use searchQuery to find columns beyond the first 100.
Report filter option, 1 operation
list_report_filter_optionsList report filter optionsGETLists up to 100 selectable values (and any sub-categories) of one filter category of a V2 report; selectableFilters is ready for start_report_task selectedFilters. Use searchQuery to find values beyond the first 100.
Report task page, 1 operation
get_report_task_pageGet report task pageGETReturns one page of a completed paginated report task (started with paginate=true). If the task is not completed yet, only message, taskId and status come back. Page numbers run from 1 to totalPages of get_report_task_status.
User balance, 1 operation
get_user_balanceGet user balancePOSTReturns a user's current point balance and its currency, the user identified by employeeId, email or username (give at least one).
Use Awardco from Claude Code, Cursor or Codex
Connect Awardco in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Awardco operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Awardco
- Create your workspace
Sign up free. Nothing to install.
- Connect Awardco once
Add your Awardco connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Awardco integration FAQ
What can you do with the Awardco integration?
LiveContext exposes 24 operations on Awardco, covering user, recognition, report and report task.
