Campaign Builder API
  1. Schemas
Campaign Builder API
  • Campaign
    • Create a new campaign
    • Update an existing campaign
    • Delete a campaign
    • List campaigns with filtering and pagination
    • Simple campaign listing
    • Get a single campaign
  • Campaign Bulk Operations
    • Archive multiple campaigns
  • Booking
    • Create new booking
    • Update booking
    • Create segmentation rule for booking
    • Get single booking by ID
    • Confirm booking
    • Get booking assets with pagination
    • Update asset status for booking
    • Update booking segmentation
    • Refresh booking segmentation
    • Export booking locations as CSV
  • Booking Campaign Integration
    • Associate campaigns with booking
    • Remove campaign from booking association
  • Entity Management
    • Create new entity
    • Update entity
    • Get single entity
    • Get entity statistics
    • Duplicate entities
    • Archive entities
    • Restore archived entities
  • Campaign Management
    • Publish a campaign
    • Send campaign preview email
  • Campaign Statistics
    • Get campaign statistics
  • Campaign Reports
    • Get available reports for a campaign
  • Campaign Pricing
    • Get campaign item pricing information
  • Campaign Asset Management
    • Get campaign item overview
    • Get priority allocations for a campaign item
    • Update priority allocations for a campaign item
  • Campaign Import
    • Export
      • Duplicate an existing campaign
      • Import artwork files for campaign items
  • Campaign Items
    • Create a new campaign item
    • Get a single campaign item
    • Update a campaign item
    • Delete a campaign item
    • List campaign items
    • Create multiple campaign items
    • Get MOS information for a campaign item
    • Delete MOS information for a campaign item
  • Campaign Items Import
    • Export
      • Export campaign items as CSV
      • Import campaign items from structured data
  • Campaign Artwork
    • Create campaign artworks in bulk
    • List campaign artworks with filtering
    • Update an existing campaign artwork
  • Campaign Artwork Management
    • Assign artworker to multiple campaign artworks
    • Cancel multiple campaign artworks
    • Duplicate multiple campaign artworks
    • Remove multiple campaign artworks
  • Schemas
    • Schemas
      • User
      • Task
      • TaskListResponse
      • ErrorResponse
      • TaskCreateRequest
      • TaskResponse
      • TaskUpdateRequest
      • UserTasksResponse
      • TaskAssignRequest
      • Opportunity
      • OpportunityResponse
      • OpportunityUpdateRequest
      • OpportunityListResponse
      • OpportunityCreateRequest
      • OpportunityTier
      • OpportunityTierResponse
      • OpportunityTierUpdateRequest
      • OpportunityTierCreateRequest
      • OpportunityTierListResponse
      • OpportunityTierAsset
      • OpportunityTierAssetResponse
      • OpportunityTierAssetUpdateRequest
      • OpportunityTierAssetCreateRequest
      • OpportunityTierAssetListResponse
      • EntityInstanceFormBase
      • EntityInstanceFormResponse
      • EntityInstanceFormUpdate
      • EntityInstanceFormCreate
      • FormGroupBase
      • FormGroupResponse
      • FormGroupCreate
      • FormGroupUpdate
      • FormFieldLabel
      • FormFieldOption
      • FormFieldIntegrationConfig
      • FormFieldLinkFilter
      • FormFieldBase
      • FormFieldResponse
      • FormFieldCreate
      • FormFieldUpdate
      • EntityInstanceFormSubmissionCreate
      • EntityInstanceFormSubmissionResponse
      • EntityInstanceFormConfigResponse
      • EntityInstanceFormSubmissionFull
      • Advertiser
      • AdvertiserListResponse
      • AdvertiserCreateRequest
      • AdvertiserResponse
      • AdvertiserUserEntity
      • AdvertiserUserBatchListResponse
      • AdvertiserUpdateRequest
      • AdvertiserUser
      • AdvertiserUserListResponse
      • AdvertiserInvite
      • AdvertiserInviteListResponse
      • AdvertiserInviteCreateRequest
      • AdvertiserInviteResponse
      • BulkAssociationCreateRequest
      • OpportunityAdvertiserAssociation
      • BulkAssociationCreateResponse
      • OpportunityAdvertiserUser
      • OpportunityAdvertiser
      • OpportunityAdvertiserListResponse
      • OpportunityAdvertiserUsersResponse
      • DeleteResponse
      • UnavailableAssetMapping
      • BookingUpdateResponse
      • BookingResponse
      • OpportunityAcceptanceResponse
      • OpportunityAcceptanceDetails
      • OpportunityAcceptanceListResponse
      • OpportunityAcceptanceRequest
      • OpportunityAcceptanceResult
      • FormTemplate
      • FormTemplateResponse
      • FormTemplateListResponse
      • FormTemplateCreateRequest
      • FormTemplateUpdateRequest
      • FormTemplateField
      • FormTemplateGroup
      • FormTemplateConfigResponse
      • FormTemplateGroupListResponse
      • FormTemplateGroupCreateRequest
      • FormTemplateGroupUpdateRequest
      • FormTemplateFieldListResponse
      • FormTemplateFieldCreateRequest
      • FormTemplateFieldUpdateRequest
      • FormTemplateFieldMoveGroupRequest
      • SegmentationRuleFilter
      • SegmentationRuleFilterGroup
      • SegmentationRuleNestedFilterGroup
      • SegmentationRuleRules
      • SegmentationRuleItem
      • SegmentationRuleCreate
      • BookingCreate
      • BookingSegmentationRuleRequest
      • BookingErrorResponse
      • BookingAssetResponse
      • BookingAssetListResponse
      • AssetStatusUpdateRequest
      • AssetStatusUpdateResponse
      • BookingUpdateRequest
      • LocationExportResponse
      • CampaignAllocationRule
      • CampaignDefaults
      • CampaignPriceMeta
      • CampaignNotificationEvent
      • CampaignCreateRequest
      • CampaignStatus
      • CampaignState
      • CampaignElementGroup
      • CampaignAssetGroup
      • Campaign
      • CampaignListResponse
      • CampaignUpdateRequest
      • CampaignItemStatus
      • CampaignItemAllocationRule
      • CampaignItem
      • CampaignItemCreateRequest
      • CampaignItemUpdateRequest
      • CampaignItemListResponse
      • CampaignArtworkCategoryGroup
      • CampaignArtworkTargetAsset
      • CampaignArtwork
      • CampaignArtworkListResponse
      • CampaignArtworkUpdateRequest
      • FormPage
      • FormGroupWithFields
      • FormPageResponse
      • FormPageUpdateRequest
      • FormPageListResponse
      • PageConfigResponse
      • FieldValuesResponse
      • FieldValueOption
      • SearchableFieldValue
      • SearchableValuesResponse
      • FormGroupCreateRequest
      • FormGroupUpdateRequest
      • FieldReorderRequest
      • FieldReorderResponse
      • BatchFieldOperation
      • BatchFieldOperationResponse
      • EntityCreateRequest
      • EntityResponse
      • EntityUpdateRequest
      • EntityStatisticsResponse
      • EntityDuplicationRequest
      • EntityDuplicationResponse
      • EntityBulkOperationRequest
      • EntityBulkOperationResponse
  1. Schemas

CampaignCreateRequest

Schema for creating a new campaign

{
    "name": "Q4 Holiday Campaign",
    "campaignType": [
        "holiday",
        "seasonal"
    ],
    "itemType": "retail",
    "department": [
        "marketing"
    ],
    "region": [
        "north"
    ],
    "brand": [
        "brand1"
    ],
    "priority": "high",
    "season": "Winter 2025",
    "month": "December",
    "year": "2025",
    "startAt": "2025-12-01T00:00:00Z",
    "endAt": "2025-12-31T23:59:59Z",
    "launchDate": "2025-12-15T00:00:00Z",
    "dueInStoreDate": "2025-12-10T00:00:00Z",
    "dispatchBy": "2025-12-08T00:00:00Z",
    "finishBy": "2025-12-05T00:00:00Z",
    "approvalDue": "2025-11-30T00:00:00Z",
    "artworkDue": "2025-11-25T00:00:00Z",
    "quoteDue": "2025-11-20T00:00:00Z",
    "briefCompletionDate": "2025-11-15T00:00:00Z",
    "workCommencesDate": "2025-11-18T00:00:00Z",
    "kickOffMeetingDate": "2025-11-10T00:00:00Z",
    "signOffDate": "2025-12-20T00:00:00Z",
    "executionDate": "2025-12-12T00:00:00Z",
    "crExpirationDate": "2025-12-31T00:00:00Z",
    "kitArrivalDate": "2025-12-07T00:00:00Z",
    "beforeKitArrivalDate": "2025-12-06T00:00:00Z",
    "afterKitArrivalDate": "2025-12-08T00:00:00Z",
    "pickingDate": "2025-12-09T00:00:00Z",
    "stockDestructionBy": "2026-01-31T00:00:00Z",
    "isFinishByIrrelevant": false,
    "isStockDestructionByIrrelevant": false,
    "purchaseOrderNumber": "PO-2025-001",
    "notes": "Special holiday promotion with extended hours",
    "prefix": "HOL",
    "defaults": {
        "departmentGroup": "retail",
        "fileCopy": 1,
        "oversType": "percent",
        "oversValue": 10,
        "rules": [
            {
                "property": "store",
                "rule": "include",
                "values": [
                    "string"
                ],
                "filters": [
                    {
                        "property": "string",
                        "ids": [
                            "497f6eca-6276-4993-bfeb-53cbbbba6f08"
                        ],
                        "values": [
                            "string"
                        ],
                        "rule": "string"
                    }
                ],
                "quantities": [
                    {
                        "property": "string",
                        "values": [
                            "string"
                        ],
                        "amounts": [
                            0
                        ]
                    }
                ]
            }
        ]
    },
    "priceMeta": {
        "packaging": 100.5,
        "delivery": 50.25,
        "additional": 25,
        "discount": 15.75,
        "installation": 200,
        "bumpOut": 75.5
    },
    "owner": "550e8400-e29b-41d4-a716-446655440000",
    "ownerPrimary": "550e8400-e29b-41d4-a716-446655440000",
    "itemOwner": "550e8400-e29b-41d4-a716-446655440000",
    "backupOwner": "550e8400-e29b-41d4-a716-446655440000",
    "kitter": "550e8400-e29b-41d4-a716-446655440000",
    "templateId": "template-123",
    "notificationTemplateId": "550e8400-e29b-41d4-a716-446655440000",
    "notificationTemplateEvents": [
        {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "name": "string",
            "isEventDate": true,
            "linkedEventId": "c5b911a2-a3f1-484d-a9a6-eb0d115510b0",
            "sendAtDays": 0,
            "sendNotifications": false,
            "attachSummaryReport": false,
            "recipients": [],
            "subject": "string",
            "message": "string",
            "departments": [],
            "date": "2019-08-24T14:15:22Z",
            "isSent": false,
            "notificationSentAt": "2019-08-24T14:15:22Z"
        }
    ],
    "tradingPeriodIds": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "campaignItemsEditOnly": false,
    "postFederationAPI": false
}
Built with