Campaigns
Bulk Update Campaign
Update multiple campaigns simultaneously with the same changes, ideal for bulk campaign management and maintenance operations.
POST
This endpoint allows you to apply the same updates to multiple campaigns at once, streamlining campaign management for scenarios where you need to modify several campaigns with identical changes.
Bulk updates are processed as a single transaction. If any campaign update fails, the entire operation is rolled back to maintain data consistency.
Path Parameters
The unique identifier of the company that owns the campaigns
Request Body
Array of campaign IDs to update
Object containing the updates to apply to all specified campaigns
Response
Indicates whether the bulk update was successful
Confirmation message or error details
Array of campaign IDs that were updated
Echo of the updates that were applied
Number of campaigns successfully updated
Array of campaigns that failed to update with error details
Timestamp when the bulk update was processed
Request Example
Response Example
Bulk Update Process
Bulk Update Process
The bulk update process follows these steps:
- Validation: All campaign IDs are validated for existence and permissions
- Pre-Check: Updates are validated against business rules for each campaign
- Transaction Start: Database transaction begins to ensure consistency
- Sequential Updates: Each campaign is updated in sequence
- Error Handling: Any failures trigger rollback of all changes
- Confirmation: Successful completion commits all changes
- Notification: Affected systems are notified of changes
Transaction Safety: Bulk updates use database transactions to ensure either all campaigns are updated successfully or none are modified, maintaining data consistency.
Performance Consideration: For large numbers of campaigns (>50), consider breaking the update into smaller batches to avoid timeout issues and improve processing speed.
Use Cases
Common Bulk Update Scenarios
Common Bulk Update Scenarios
Seasonal Campaign Management
- Update end dates for all seasonal campaigns
- Change status of holiday campaigns to inactive
- Extend successful campaigns across multiple products
- Update campaign descriptions for regulatory compliance
- Modify campaign terms across all active promotions
- Apply uniform changes for legal requirements
- Update campaign naming conventions
- Standardize descriptions across campaigns
- Apply consistent messaging and branding
- Pause underperforming campaigns simultaneously
- Extend high-performing campaigns
- Adjust timing based on analytics insights
- Archive completed campaigns
- Update campaign ownership or management
- Apply system-wide configuration changes
Error Handling
Bulk Update Error Scenarios
Bulk Update Error Scenarios
Partial Failure ResponseValidation ErrorTransaction Rollback
Impact Assessment: Bulk updates affect multiple campaigns simultaneously. Ensure you understand the impact on active promotions, customer experience, and store operations before proceeding.
Best Practices
Bulk Update Best Practices
Bulk Update Best Practices
Planning
- Test bulk updates on a small subset first
- Verify campaign IDs before executing large updates
- Consider timing of updates relative to customer activity
- Ensure all update fields are valid for all target campaigns
- Check date ranges and status transitions for consistency
- Validate permissions for all campaigns being updated
- Monitor system performance during large bulk updates
- Track success rates and error patterns
- Set up alerts for bulk update failures
- Have rollback procedures ready for failed updates
- Maintain backups before large bulk operations
- Document changes for audit and troubleshooting
Limitations
Bulk Update Limitations
Bulk Update Limitations
Campaign Limits
- Maximum 100 campaigns per bulk update request
- Processing timeout after 5 minutes
- Memory limitations for very large updates
- Some fields may not be suitable for bulk updates
- Campaign-specific settings cannot be bulk updated
- Image uploads not supported in bulk operations
- Some status transitions may not be allowed for all campaigns
- Campaign dependencies may prevent bulk status changes
- Business rules apply to each campaign individually