POST
{micro_service_base_url}
/
stores
/
company
/
{company_id}
/
campaigns
{
  "id": "<string>",
  "company_id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "start_date": "<string>",
  "end_date": "<string>",
  "status": "<string>",
  "image": "<string>",
  "created_by": "<string>",
  "updated_by": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>",
  "deletedAt": "<string>"
}
This endpoint allows you to create comprehensive marketing campaigns for your company. Campaigns can include rich media content, precise scheduling, and detailed targeting criteria to maximize marketing effectiveness.
New campaigns are created in the specified status and can be immediately associated with stores and promotions for complete marketing campaign setup.

​
Path Parameters

​
company_id
string
required
The unique identifier of the company creating the campaign

​
Request Body

​
name
string
required
Campaign name for identification and management
​
description
string
required
Detailed description of the campaign objectives and content
​
start_date
string
required
Campaign start date (YYYY-MM-DD format)
​
end_date
string
required
Campaign end date (YYYY-MM-DD format)
​
status
string
required
Campaign status: “active”, “inactive”, “scheduled”, “expired”
​
image
string
Base64 encoded image data for campaign visual assets

​
Response

​
id
string
Unique campaign identifier
​
company_id
string
Company identifier this campaign belongs to
​
name
string
Campaign name
​
description
string
Campaign description
​
start_date
string
Campaign start date
​
end_date
string
Campaign end date
​
status
string
Current campaign status
​
image
string
URL to the uploaded campaign image
​
created_by
string
ID of the user who created the campaign
​
updated_by
string
ID of the user who last updated the campaign
​
created_at
string
Campaign creation timestamp
​
updated_at
string
Campaign last update timestamp
​
deletedAt
string
Deletion timestamp (null for active campaigns)

​
Request Example

{
  "description": "Spring seasonal promotion featuring fresh products and outdoor essentials",
  "end_date": "2025-03-25",
  "start_date": "2025-12-31",
  "name": "Spring Fresh Campaign",
  "status": "active",
  "image": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8/5+hHgAHggJ/PchI7wAAAABJRU5ErkJggg=="
}

​
Response Example

{
  "id": "1000010",
  "company_id": "1000058",
  "description": "Spring seasonal promotion featuring fresh products and outdoor essentials",
  "end_date": "2025-03-25",
  "start_date": "2025-12-31",
  "name": "Spring Fresh Campaign",
  "status": "active",
  "image": "https://lula-stores-service-staging.s3.amazonaws.com/company/1000058/campaigns/1000010/1744591882710.webp",
  "created_by": "1000418",
  "updated_by": "1000418",
  "updated_at": "2025-04-14T00:51:22.994Z",
  "created_at": "2025-04-14T00:51:22.994Z",
  "deletedAt": null
}
Image Processing: Campaign images are automatically processed, optimized, and stored in cloud storage. The response includes the final image URL for use in marketing materials.
Date Validation: Ensure end_date is after start_date and both dates are in the future for scheduled campaigns. Past dates are allowed for historical campaign tracking.

​
Campaign Status Guide

​
Error Responses

Image Size: Campaign images should be optimized for web use. Large images may cause processing delays or failures. Recommended maximum size is 2MB.

​
Use Cases