The CloudRadial AutomationAI Pax8 extension lets a workflow or agent work with your Pax8 partner account: look up companies and contacts, search the product catalog and pricing, review orders, subscriptions, invoices, and usage, and, with approval, place orders and change subscriptions. This article covers what the extension can do, the runner version and API credentials it needs, which tools require approval, and the skills that ship with it. It is for workspace users who build automations (Admin or Owner Role).
The Pax8 extension requires a runner on version 2.5.0 or later. On an earlier runner, every Pax8 call fails when the runner requests a sign-in token. See Upgrading a runner to a new version.
- What the Extension Covers
- Creating Pax8 API Credentials
- Providing the Credentials to Your Runner
- Reads and Approval-Gated Changes
- Validating an Order First
- How Lists Are Paged
- Skills
- Tips for Working With Pax8 Data
What the Extension Covers
The extension calls the Pax8 Partner API and provides 33 tools across these areas:
| Area | What you can automate |
| Companies and contacts | List and look up companies and their contacts, and create or update a company or contact |
| Product catalog | Search products by name or vendor, and read a product's pricing, the provisioning details an order needs, and its dependencies and commitment terms. Read-only. |
| Orders | List and look up orders, and place a new order |
| Subscriptions | List and look up subscriptions and their change history, add a product, change quantity, price, billing term, or start date, and cancel a subscription |
| Invoices | List and look up invoices, read invoice line items, and see draft (not yet invoiced) charges for the current or next month. Read-only. |
| Usage | Read usage summaries for a usage-based subscription and the usage lines for a single day. Read-only. |
| Quotes and webhooks | List and look up quotes, list your Pax8 webhooks, and read a webhook's delivery logs. Read-only. |
Install it from Extensions like any other catalog extension. See Browsing and installing extensions for the general install flow.
Creating Pax8 API Credentials
The extension signs in to Pax8 with OAuth client credentials: a client ID and a client secret from a Pax8 API application.
- In the Pax8 app, go to Integrations > API credentials and create an API application.
- Copy the client ID.
- Copy the client secret. Pax8 shows it only once, at creation, so store it somewhere safe before you leave the page.
The runner requests a Pax8 access token with these credentials and sends it on every call. You do not need to enter a Pax8 server address; the extension always calls the Pax8 Partner API.
Providing the Credentials to Your Runner
Store two secrets in your runner's Key Vault with these exact names:
| Secret | Value |
Pax8-ClientId |
The client ID of your Pax8 API application |
Pax8-ClientSecret |
The client secret paired with that client ID |
For how to add these, see Accessing and updating your runner's Key Vault. The agent reads the credentials from the runner and never asks you for them. Once the secrets are in place, ask the AI Playground to list your Pax8 companies to confirm the connection works.
Reads and Approval-Gated Changes
Of the 33 tools, 25 are read-only and run without interruption. The other 8 create, change, or cancel something, and every one of them is approval-gated: the run pauses and the request appears as an Action Required item in the Inbox until someone approves it. See Handling Action Required items in the Inbox.
| Tool behavior | Tools |
| Approval-gated, and billed | Place an order; create a subscription (places a single-product order); update a subscription's quantity, price, billing term, or start date; cancel a subscription |
| Approval-gated | Create or update a company; create or update a company contact |
| Read-only | Every list and get tool for companies, contacts, products, orders, subscriptions, invoices, usage, quotes, and webhooks |
Orders, quantity changes, and cancellations change what you are billed by Pax8. Before you approve one, check the company, product, quantity, and billing term in the request; the agent states them before it asks.
Validating an Order First
Both order tools (place an order, and create a subscription) place a Pax8 order and accept an isMock option. With isMock set to true, Pax8 validates the order without placing it: an invalid order returns an error, and a valid order returns success but is not placed and creates no data in Pax8. This lets you catch a problem with an order before anything is billed. The ordering skills validate first, then place the real order once it is approved. See Pax8's Ordering Products documentation.
When you build a workflow that orders, do the same: run the order with isMock set to true, review the result, and then run it again without the option. Before ordering, the agent also looks up the product's provisioning details and, where required, its commitment term, so the order carries everything Pax8 needs.
How Lists Are Paged
The 13 list tools (companies, contacts, products, orders, subscriptions, invoices, invoice items, draft charges, usage summaries, usage lines, quotes, webhooks, and webhook logs) page through results automatically, 200 records per page, and return the full list. You do not pass a page number or page size.
Each list tool has a maximum number of pages it will fetch. If a list is larger than that, the call fails with a pagination error rather than returning a partial list. Narrow the request with the tool's filters instead, such as a company, status, billing term, vendor name, or search text. This matters most for the product catalog, which is large: search by product name or vendor rather than listing every product.
Skills
The extension ships six skills that guide an agent through common Pax8 tasks:
| Skill | Use it to |
| Manage Pax8 Companies and Contacts | Find, create, or update companies and their contacts. Writes are approval-gated. |
| Place and Review Pax8 Orders | Review orders, or place a new one. The agent resolves the company, product, provisioning details, and commitment term, validates the order first, and places it once approved. |
| Review Pax8 Invoices and Usage | Review invoices, invoice lines, upcoming draft charges, and usage for usage-based subscriptions, or reconcile Pax8 billing against your PSA. Read-only. |
| Review Pax8 Quotes and Webhooks | Read quotes, webhooks, and webhook delivery logs, for example to troubleshoot event delivery. Read-only. |
| Review and Change Pax8 Subscriptions | List or read subscriptions and their history, add a product, or change quantity, price, or term, or cancel. The agent confirms the current quantity first and reports the old and new values. Changes are approval-gated. |
| Search the Pax8 Catalog | Find products, pricing (including company-specific pricing), provisioning fields, and commitment terms. Read-only. |
Tips for Working With Pax8 Data
- Pax8 ids are long unique identifiers (UUIDs). Refer to companies and products by name and let the agent look up the id; it lists and matches rather than guessing.
- Set a company's external ID to its client ID in your PSA. The billing reconciliation skill uses it to pair each Pax8 company with the right PSA client, and falls back to the name.
- To see charges that are not on an invoice yet, ask for draft charges for the current month or next month
- Usage lines are read one day at a time, so give the date you want, for example
2026-10-01 - Billing terms are Monthly, Annual, 2-Year, 3-Year, One-Time, Trial, and Activation
- Updating a contact replaces the whole contact, so the agent sends every field, not only the one you change
- When you cancel a subscription, you can give a cancel date. Without one, Pax8 uses the earliest date it allows.
- The extension does not delete companies or contacts. Cancelling a subscription is the only removal it can make, and it requires approval.
- If every Pax8 call fails at sign-in, check that your runner is on version 2.5.0 or later and that both secrets are set with the exact names above
If you are still having trouble, we’re here to help! Submit a ticket here for assistance, and don’t forget to check our status page to ensure there are no outages in your area.
Comments
0 comments
Please sign in to leave a comment.