---
title: Common workflows
slug: commerce-connect-14/docs/common-workflows
docTags: 
createdAt: 2026-07-23T10:25:35.210Z
---

The following sections are some of the ways you can use Agent Platform to create and edit promotions in Optimizely Commerce Connect.

## Create a campaign with promotions

1. List available campaign types.

```json
Tool: campaign_types_list
```

2. Create the campaign.

```json
Tool: campaign_create
{
  "Name": "Holiday Sale 2024",
  "ValidFrom": "2024-12-01T00:00:00Z",
  "ValidUntil": "2024-12-31T23:59:59Z"
}
```

3. List available promotion types.

```json
Tool: promotion_types_list
```

4. Create promotions within the campaign.

```json
Tool: promotion_create
{
  "Name": "25% Off All Items",
  "Campaign": "Holiday Sale 2024",
  "PromotionType": "EPiServer.Commerce.Marketing.Promotions.SpendAmountGetOrderDiscount"
}
```

5. Configure promotion properties.

```json
Tool: promotion_dynamic_update
{
  "Id": "456",
  "Properties": {
    "Condition_SpendAmount": 50.00,
    "Discount_Percentage": 25.0
  }
}
```

## Clone and modify a promotion

1. Find the source promotion.

```json
Tool: promotion_filter
{ "Name": "Summer Discount" }
```

2. Get promotion details.

```json
Tool: promotion_detail
{ "Identifier": "456", "IncludeAdditionalDetails": true }
```

3. Clone the promotion.

```json
Tool: promotion_clone
{ "PromotionId": "456", "CampaignId": "789" }
```

4. Update the cloned promotion.

```json
Tool: promotion_update
{ "Id": "new-id", "Name": "Winter Discount" }
```

## Analyze promotion performance

1. List promotions by sales.

```json
Tool: promotion_list_by_sales
{ "MarketId": "US" }
```

2. Get details of top-performing promotion.

```json
Tool: promotion_detail
{ "Identifier": "top-promotion-id", "IncludeAdditionalDetails": true }
```