Listing Management

Create and manage your cloud marketplace product listings from a unified interface.

Overview

The Listings module allows you to manage your product offerings across AWS and Azure Marketplaces. Create new products, update pricing, sync metadata, and track listing performance.

What is a Listing?

A listing represents a product or service offered on a cloud marketplace. Each listing includes:

Product information (name, description, features)
Pricing details (subscription, contract, or hybrid)
Support information
Technical requirements
Legal terms and conditions

Listing Types

AWS Marketplace

SaaS Products

Subscription-based
Contract-based (with flexible payment schedules)
Usage-based metering
Free trials

AMI/Container Products

Hourly pricing
Annual subscriptions
BYOL (Bring Your Own License)

Azure Marketplace

SaaS Applications

Per-user pricing
Flat-rate pricing
Usage-based pricing

Azure Applications

Solution templates
Managed applications

Virtual Machines

PAYG (Pay-As-You-Go)
BYOL

Viewing Listings

Access your listings from the main navigation:

Dashboard View:

Grid or list view
Quick status indicators
Key metrics per listing

Filters:

Marketplace (AWS, Azure)
Status (Draft, Preview, Live, Retired)
Product type
Pricing model

Creating a New Listing

AWS Marketplace Listing

Navigate to Listings > New Listing
Select AWS Marketplace
Follow the wizard:

Step 1: Product Details

Required Fields:

Product title: 1-255 characters
Short description: Brief overview (required)
Long description: Detailed product information (required)
Highlights: Array of key features (required)
Keywords: Array of search keywords (required)
Categories: At least one category (required)
Product logo (120x120px minimum)
Screenshots

Validation Rules

Title must be 1-255 characters
At least one category is required
Highlights and keywords arrays cannot be empty
All dimension API keys must be unique

Step 2: Pricing Configuration

Pricing Types:

subscription: Monthly/annual subscriptions
contract: Contract with upfront payment
contract_with_payg: Contract + usage-based metering

Subscription Model:

json

{
  "productType": "subscription",
  "options": [
    {
      "apiKey": "basic",
      "title": "Basic Plan",
      "description": "For small teams",
      "price": {
        "oneMonth": "99",
        "oneYear": "999"
      }
    }
  ],
  "durations": ["oneMonth", "oneYear"]
}

Contract Model:

json

{
  "productType": "contract",
  "durations": ["oneYear", "twoYear", "threeYear"],
  "options": [
    {
      "apiKey": "enterprise",
      "title": "Enterprise",
      "price": {
        "oneYear": "10000",
        "twoYear": "18000",
        "threeYear": "25000"
      }
    }
  ]
}

Contract Pricing

Contract products must have at least one option with upfront pricing. At least one price must be specified for the contract durations.

Usage-Based (Metered):

json

{
  "additionalUsages": [
    {
      "apiKey": "api_calls",
      "title": "API Calls",
      "description": "Per 1000 API calls",
      "per": "1000 requests",
      "price": "0.10"
    }
  ]
}

Dimension Requirements:

Each dimension must have a unique apiKey
Each dimension must have a title
API keys must be non-empty strings

Step 3: Support Information

Support email
Support URL
Refund policy
Service Level Agreement (SLA)

Step 4: Technical Details

Fulfillment URL (for SaaS)
Product dimensions (for metering)
Integration requirements
System requirements

Step 5: Review & Submit

Preview your listing
Submit to AWS Marketplace
Track submission status

Azure Marketplace Listing

Similar process with Azure-specific fields:

Plan Configuration
- Plan ID
- Plan name
- Plan description
- Billing terms
Pricing and Availability
- Markets/regions
- Pricing per market
- Private plans
Technical Configuration
- Landing page URL
- Connection webhook
- Azure AD tenant ID
Review and Publish

Syncing Listings

Import existing listings from marketplaces:

AWS Sync

Go to Listings > Sync from AWS
Select AWS account
Choose products to import
Click Import Selected

Automatum syncs:

Product details
Current pricing
Dimensions (for metered products)
Private offers
Customer subscriptions

Azure Sync

Go to Listings > Sync from Azure
Select Azure publisher account
Choose offers to import
Select specific plans
Click Import Selected

Automatum syncs:

Offer details
Plan configurations
Pricing information
Private offers
Subscriptions

Automatic Sync

Enable automatic sync in Settings to keep listings updated hourly.

Editing Listings

Update Product Information

Navigate to listing details page
Click Edit on any section
Make changes
Click Save Changes

Approval Required

Changes to live listings may require marketplace approval and can take 3-5 business days.

Update Pricing

For Subscription/Contract Products:

Go to Pricing tab
Click Edit Pricing
Modify prices for each duration
Click Submit for Approval

For Metered Products:

Go to Dimensions tab
Select dimension to edit
Update price per unit
Click Submit for Approval

Listing Status

Track your listing through its lifecycle:

Status	Description	Next Step
`incomplete`	Listing data is incomplete	Complete all required fields
`deploying-aws`	Submitting listing data to AWS Marketplace	Automated - wait for AWS
`validating-aws`	AWS Marketplace is validating the listing	Wait for AWS validation (3-5 days)
`preview-aws`	AWS product is in LIMITED state	Test and create private offers
`publishing-aws`	Changing AWS product from LIMITED to PUBLIC	Automated - wait for AWS
`deploying-azure`	Submitting listing data to Azure Marketplace	Automated - wait for Azure
`validating-azure`	Azure Marketplace is validating the listing	Wait for Azure validation
`preview-azure`	Azure product is in DRAFT state	Test before preview
`testing-azure`	Changing Azure product from DRAFT to PREVIEW	Automated - wait for Azure
`publishing-azure`	Changing Azure product from PREVIEW to LIVE	Automated - wait for Azure
`listed`	Deployment complete and product is publicly listed	Monitor and manage
`updating-pricing`	Pricing changes are being processed	Wait for marketplace approval
`offboarded`	Listing has been removed from marketplace	Archive

Synced Listings

When syncing an existing product from AWS/Azure, the status is automatically set based on the product's current state in the marketplace.

Product Categories

Performance Metrics

View listing performance:

Overview Metrics

Total views
Unique visitors
Conversion rate
Active subscriptions
Revenue generated

Customer Insights

Geographic distribution
Industry breakdown
Company size
Purchase patterns

SEO Optimization

Improve listing visibility:

Keywords

Include relevant technical terms
Use customer language
Research competitor listings
Test different variations

Description Best Practices

Start with key benefits
Use bullet points
Include use cases
Add technical specifications
Highlight differentiators

Visual Assets

High-quality screenshots
Demo videos
Architecture diagrams
Customer logos (with permission)

A/B Testing

Test listing variations:

Create multiple versions
Split traffic
Measure conversion rates
Analyze results
Apply winning variation

TIP

Test one element at a time (price, description, images) for clear insights.

Private Offer Creation

Create custom deals for specific customers:

From Listings Page

Navigate to Listings
Click on a listing
Click Create Private Offer button
Listing is pre-selected in the form
Fill in customer details and customize pricing
Submit to marketplace

From Private Offers Page

Navigate to Private Offers
Click Create Private Offer
Select the listing from dropdown
Fill in customer details
Customize pricing (discount from public pricing)
Submit to marketplace

Listing Status

You can create private offers for listings in any status, including preview-aws and preview-azure, before the product is publicly listed.

API Integration

Manage listings programmatically:

Get All Listings

bash

GET /listing
Authorization: Bearer YOUR_TOKEN

Response:

json

{
  "code": 200,
  "data": [
    {
      "id": "listing-uuid",
      "organizationId": "org-uuid",
      "status": "listed",
      "details": {
        "summary": {
          "name": "My SaaS Product",
          "description": "Product description"
        },
        "amazon": {
          "pricing": {
            "productType": "subscription",
            "options": [...],
            "additionalUsages": [...]
          }
        }
      },
      "createdAt": "2026-01-15T10:00:00Z",
      "updatedAt": "2026-01-15T10:00:00Z"
    }
  ]
}

Get Listing Details

bash

GET /listing/:id
Authorization: Bearer YOUR_TOKEN

Create Listing

bash

POST /listing
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "status": "incomplete",
  "details": {
    "summary": {
      "name": "My Product",
      "description": "Short description"
    },
    "amazon": {
      "pricing": {
        "productType": "subscription",
        "options": []
      }
    }
  }
}

Update Listing

bash

PUT /listing/:id
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "data": {
    "details": {
      "summary": {
        "description": "Updated description"
      }
    }
  }
}

Delete Listing

bash

DELETE /listing/:id
Authorization: Bearer YOUR_TOKEN

Sync from AWS Marketplace

bash

PATCH /listing/:id/sync/aws/:productId
Authorization: Bearer YOUR_TOKEN

This endpoint syncs an existing AWS Marketplace product into Automatum. The listing ID should be created first with status incomplete, then use this endpoint to sync marketplace data.

Assume Role (Verify AWS Access)

bash

POST /listing/:id/assume-role
Authorization: Bearer YOUR_TOKEN

Tests AWS IAM role assumption for the listing's AWS account to verify proper access configuration.

Best Practices

Complete Profiles: Fill out all optional fields for better visibility
Professional Assets: Use high-quality images and videos
Clear Pricing: Make pricing transparent and easy to understand
Regular Updates: Keep descriptions and features current
Monitor Performance: Review metrics weekly and optimize

Known Limitations

AWS Marketplace

Products are initially created in LIMITED mode (private access only)
New products can take 3-5 business days for AWS validation
Pricing changes require marketplace approval
Products must have fulfillment URL configured
Contract products must have at least one pricing option

Azure Marketplace

Plans cannot be deleted once created, only deactivated
Custom amendments are limited to 10 per listing
Each custom amendment can have up to 20 tenant IDs
Pricing changes require marketplace approval

General

Cannot have duplicate dimension apiKey values
Title must be 1-255 characters
All pricing values must be strings in the API
Synced listings cannot be deployed again (deployment already exists)

Troubleshooting

Listing Not Syncing

Error: "Deployment already exists with id..."

This listing was already deployed to AWS/Azure
Use the sync endpoint instead: PATCH /listing/:id/sync/:marketplace/:productId
Cannot redeploy an existing product

Error: "AWS account not found"

Verify AWS IAM role is configured in organization settings
Check that External ID matches
Use POST /listing/:id/assume-role to test access

Validation Errors

"ProductTitle must be 1..255 chars"

Product name is too long or empty
Maximum 255 characters allowed

"At least one Category required"

Must select at least one category from the available options

"contract requires options for upfront pricing"

Contract products must have at least one pricing option defined
Add pricing for at least one contract duration

"dimension[X].apiKey required"

All pricing dimensions must have a unique apiKey
API keys cannot be empty strings

Pricing Changes Not Applying

Check approval status in AWS/Azure Marketplace console
Verify changes were submitted correctly
Allow 3-5 business days for marketplace approval
Listing status will be updating-pricing during this time
Contact marketplace support if delayed beyond 5 days

Next Steps

Need Help?

Contact support@automatum.io for assistance with listing management.

Listing Management ​

Overview ​

What is a Listing? ​

Listing Types ​

AWS Marketplace ​

Azure Marketplace ​

Viewing Listings ​

Creating a New Listing ​

AWS Marketplace Listing ​

Step 1: Product Details ​

Step 2: Pricing Configuration ​

Step 3: Support Information ​

Step 4: Technical Details ​

Step 5: Review & Submit ​

Azure Marketplace Listing ​

Syncing Listings ​

AWS Sync ​

Azure Sync ​

Editing Listings ​

Update Product Information ​

Update Pricing ​

Listing Status ​

Product Categories ​

AWS Categories ​

Azure Categories ​

Performance Metrics ​

Overview Metrics ​

Customer Insights ​

SEO Optimization ​

Keywords ​

Description Best Practices ​

Visual Assets ​

A/B Testing ​

Private Offer Creation ​

From Listings Page ​

From Private Offers Page ​

API Integration ​

Get All Listings ​

Get Listing Details ​

Create Listing ​

Update Listing ​

Delete Listing ​

Sync from AWS Marketplace ​

Assume Role (Verify AWS Access) ​

Best Practices ​

Known Limitations ​

AWS Marketplace ​

Azure Marketplace ​

General ​

Troubleshooting ​

Listing Not Syncing ​

Validation Errors ​

Pricing Changes Not Applying ​

Next Steps ​

Need Help? ​

Listing Management

Overview

What is a Listing?

Listing Types

AWS Marketplace

Azure Marketplace

Viewing Listings

Creating a New Listing

AWS Marketplace Listing

Step 1: Product Details

Step 2: Pricing Configuration

Step 3: Support Information

Step 4: Technical Details

Step 5: Review & Submit

Azure Marketplace Listing

Syncing Listings

AWS Sync

Azure Sync

Editing Listings

Update Product Information

Update Pricing

Listing Status

Product Categories

AWS Categories

Azure Categories

Performance Metrics

Overview Metrics

Customer Insights

SEO Optimization

Keywords

Description Best Practices

Visual Assets

A/B Testing

Private Offer Creation

From Listings Page

From Private Offers Page

API Integration

Get All Listings

Get Listing Details

Create Listing

Update Listing

Delete Listing

Sync from AWS Marketplace

Assume Role (Verify AWS Access)

Best Practices

Known Limitations

AWS Marketplace

Azure Marketplace

General

Troubleshooting

Listing Not Syncing

Validation Errors

Pricing Changes Not Applying

Next Steps

Need Help?