Import campaign items from structured data

Imports campaign items and associated item data into a specified campaign.

Import Process:

Validates all element product codes exist

Creates or updates Item entities based on provided data

Creates CampaignItem entities linking items to the campaign

Handles artwork creation and association

Processes custom fields and metadata

Validates user assignments and ownership

Data Validation:

All element product codes must exist in the system

User references (owner, backupOwner) must be valid

Tag names are validated and created if necessary

Date fields are properly formatted and validated

Artwork data is validated for proper structure

Business Rules:

Campaign must exist and be accessible

User must have permission to create items in the campaign

Element product codes must be valid and active

Artwork entities are created as needed

Tags are created if they don't exist

Side Effects:

Creates Item entities for new items

Creates CampaignItem entities linking to campaign

Creates Artwork entities for artwork data

Creates Tag entities for new tag names

Updates campaign modification timestamp

curl --location --request POST 'https://prod.your-api-server.com/campaign-items/550e8400-e29b-41d4-a716-446655440000/import' \ --header 'Authorization: <api-key>' \ --header 'Content-Type: application/json' \ --data-raw '{ "campaignItemEntities": [ { "id": null, "itemPosNumber": "FLY001", "meta": { "priority": "high" } }, { "id": null, "itemPosNumber": "BAN001", "meta": { "priority": "medium" } } ], "itemEntities": [ { "name": "Promotional Flyer", "tags": [ "marketing", "promotional" ], "posNumber": "FLY001", "extraInfo": "A4 size promotional flyer", "elementProductCode": "ELE001", "artworks": [ { "id": null, "name": "Flyer Design v1", "link": "https://example.com/artwork1", "providedBy": "Design Team", "creativeVendor": "Creative Co", "printVendor": "Print Shop" } ], "liveFrom": "2025-10-01T00:00:00Z", "liveTo": "2025-12-31T23:59:59Z", "owner": "john.doe@example.com", "backupOwner": "jane.smith@example.com", "meta": { "category": "print" } }, { "name": "Store Banner", "tags": [ "signage", "display" ], "posNumber": "BAN001", "elementProductCode": "ELE002", "artworks": [], "owner": "design.team@example.com", "meta": { "category": "digital" } } ] }'

{ "campaignItemIds": [ "880e8400-e29b-41d4-a716-446655440003", "880e8400-e29b-41d4-a716-446655440004" ], "campaignItemEntities": { "880e8400-e29b-41d4-a716-446655440003": { "_id": "880e8400-e29b-41d4-a716-446655440003", "campaignId": "550e8400-e29b-41d4-a716-446655440000", "itemId": "660e8400-e29b-41d4-a716-446655440001", "status": 101, "qty": 500 } }, "itemIds": [ "660e8400-e29b-41d4-a716-446655440001", "660e8400-e29b-41d4-a716-446655440002" ], "itemEntities": { "660e8400-e29b-41d4-a716-446655440001": { "_id": "660e8400-e29b-41d4-a716-446655440001", "name": "Promotional Flyer", "posNumber": "FLY001" } }, "artworkIds": [], "artworkEntities": {}, "tagIds": [], "message": "Campaign items imported successfully" }

Import campaign items from structured data

Request

Responses