Pax8

Overview

The Pax8 integration enables automated management of cloud subscriptions, licensing, and billing through Bumblebee workflows. Streamline your cloud distribution operations with seamless Pax8 marketplace integration.

Prerequisites & Setup

Before setting up the Pax8 integration, you need:

An active Pax8 partner account
Administrator access to your Pax8 account
OAuth2 credentials from the Pax8 Developer Portal

Authorize via Pax8 OAuth

Pax8 uses an OAuth2 authorization code flow. Bumblebee needs the following credentials, which are obtained through the Pax8 OAuth consent process.

Configure in Bumblebee

Go to the Integrations page in Bumblebee
Select Pax8
Complete the OAuth authorization flow to grant Bumblebee access to your Pax8 account
Bumblebee stores and auto-refreshes your tokens -- no manual token management required
Click Test Connection
Save the configuration

Available Tools

Subscriptions

list_subscriptions - List Pax8 subscriptions. Required: none. Optional: company_id (str), product_id (str), status (str), max_records (int)
list_subscriptions_by_company_id - List Pax8 subscriptions for a specific company. Required: company_id (str)
get_subscription_by_id - Get a specific Pax8 subscription by ID. Required: subscription_id (str)
get_subscription_history_by_id - Get historical changes for a Pax8 subscription. Required: subscription_id (str)
update_subscription - Update a Pax8 subscription quantity to increase or decrease license count. Required: subscription_id (str), quantity (int)
cancel_subscription - Cancel a Pax8 subscription by ID. Required: subscription_id (str)

Companies

list_companies - List all Pax8 companies. Required: none
get_company_by_id - Get a specific Pax8 company by ID. Required: company_id (str)
list_companies_by_name - List Pax8 companies matching the given name. This method uses exact name match (case-insensitive). Required: company_name (str)
create_company - Create a new company in Pax8. Required: name (str), street (str), city (str), postal_code (str), country (str), state_or_province (str), phone (str). Optional: website (str), bill_on_behalf_of_enabled (bool), order_approval_required (bool)
update_company - Update an existing Pax8 company. All address fields are required by the API. Required: company_id (str), name (str), street (str), city (str), postal_code (str), country (str), state_or_province (str), phone (str). Optional: website (str), bill_on_behalf_of_enabled (bool), order_approval_required (bool)

Contacts

list_contacts - List contacts for a Pax8 company. Required: company_id (str). Optional: max_records (int)
get_contact_by_id - Get a specific contact's details by ID. Required: company_id (str), contact_id (str)
create_contact - Create a contact under a Pax8 company. Required: company_id (str), first_name (str), last_name (str), email (str). Optional: phone (str), types (List[str])

Products

list_products - List Pax8 products with optional vendor filter. Required: none. Optional: vendor_name (str), max_records (int)
search_products_by_name - Search Pax8 product catalog by product name. Required: product_name (str)
get_product_by_id - Get a single Pax8 product by ID. Required: product_id (str)
batch_get_product_by_id - Get multiple Pax8 products by their IDs in a single batch operation. Required: product_ids (List[str])
get_product_pricing - Get pricing details for a Pax8 product, including MSRP, partner cost, and billing frequency. Required: product_id (str)
get_product_dependencies - Get prerequisite products/SKUs required before a given product can be ordered. Required: product_id (str)
get_provisioning_details - Get provisioning requirements and fields needed to complete an order for a Pax8 product. Required: product_id (str)

Invoices & Billing

list_invoices - List Pax8 invoices with optional filters. Required: none. Optional: status (str), invoice_date_start (str), invoice_date_end (str), max_records (int)
get_invoice_by_id - Get full Pax8 invoice detail by ID, including totals, tax, and metadata. Required: invoice_id (str)
list_invoice_items - List line items for a specific Pax8 invoice. Required: invoice_id (str). Optional: company_id (str), max_records (int)

Orders & Provisioning

list_orders - List Pax8 orders with optional filters. Required: none. Optional: company_id (str), status (str), max_records (int)
get_order_by_id - Get Pax8 order details by ID, including line items and fulfillment status. Required: order_id (str)
create_order - Place a new Pax8 order for a company. Required: company_id (str), line_items (List[Dict])

Usage & Consumption

list_usage_summaries - List usage/consumption summaries for a specific Pax8 subscription. Required: subscription_id (str). Optional: max_records (int)
get_usage_line_items - Get detailed consumption line items for a usage summary. Required: usage_summary_id (str). Optional: max_records (int)

Webhooks

list_webhooks - List all Pax8 webhooks configured for this account. Required: none. Optional: max_records (int)
create_webhook - Create a new Pax8 webhook subscription. Required: display_name (str), url (str). Optional: active (bool), webhook_topics (List[Dict]), contact_email (str), authorization (str)
get_webhook_by_id - Get a Pax8 webhook by ID. Required: webhook_id (str)
delete_webhook - Delete a Pax8 webhook by ID. Required: webhook_id (str)

Quotes

list_quotes - List Pax8 quotes with optional filters. Required: none. Optional: status (str), search (str), max_records (int)
get_quote_detail - Get full Pax8 quote details including line items and sections in a single call. Required: quote_id (str)