Skip to main content
Ask ChatGPT

Aprimo PM API Quick Start

A downloadable Claude skill that gets an AI agent productive against the Aprimo Productivity Management (PM) REST API in minutes. Install it, then ask the agent to help you authenticate, list and search activities and other PM objects, work with extended attributes, and troubleshoot common errors — the agent reads the skill's guidance and the bundled OpenAPI specification to answer accurately and generate working code.

This skill covers the PM REST API, which serves both Aprimo Productivity and Aprimo Spend. For the Digital Asset Management (DAM) REST API, see the Aprimo DAM API Quick Start skill instead.

Download the Aprimo PM API Quick Start skill

What's in the package​

The download is a .zip containing a single skill folder, aprimo-pm-api-quickstart/, with:

  • SKILL.md — the skill instructions the agent reads: a 60-second setup, code examples, essential concepts, common tasks, and troubleshooting.
  • PMOpenAPI.json — the PM OpenAPI specification, so the agent can reference exact endpoints, parameters, and response shapes. This is the same spec published on the Aprimo Productivity OpenAPI page.

What the skill covers​

  • Authentication — requesting an access token with the Client Credentials OAuth flow.
  • First calls — listing activities and reading the paged, HAL-style response.
  • Code examples — ready-to-adapt snippets in Python, JavaScript / TypeScript, and C#.
  • Essential concepts — the paged _embedded / _links response shape (keyed by the resource's singular type name, not the plural route), CRUD verbs and flush-and-fill updates, pagination, search operators, extended attribute syntax, and the lack of DAM-style select-headers.
  • Common tasks — listing and searching activities, fetching a single record, finding attachments for an object, and pointers for creating resources.
  • Troubleshooting — handling 401, 403/404, 500, and 400 responses, including the empty extended-attribute-collection gotcha.
  • Using the OpenAPI spec — importing into POSTMAN, generating SDKs, and IDE autocomplete.

Install and use it​

  1. Download the package above and unzip it.
  2. Install it by placing the aprimo-pm-api-quickstart/ folder into a Claude skills directory — for example .claude/skills/ in your project or home directory.
  3. Use it — start a session and ask questions such as:
    • "Show me how to search activities by owner in Python."
    • "What does a flush-and-fill PUT mean for updating a task?"
    • "Generate a Node.js client for creating an Aprimo Spend invoice."

The agent loads the skill automatically when your request relates to the Aprimo PM API.

tip

The skill points the agent at the AI-readable documentation at developers.aprimo.com/llms.txt for deeper reference, so it can pull in advanced patterns and detailed API behavior beyond what's bundled.