Associate campaigns with booking

PATCH

/booking/{id}/campaigns

Associates one or more campaigns with a booking, enabling campaign-specific asset allocation and management.

Business Rules:

Campaign IDs must reference valid, accessible campaigns

Campaigns must be compatible with booking date range and asset requirements

Association triggers asset allocation updates for affected campaigns

Existing campaign associations are preserved unless explicitly overridden

Campaign segmentation rules are copied from booking when association is created

Integration Effects:

Updates booking's campaignIds array with new associations

Copies booking segmentation rules to associated campaigns

Triggers asset allocation recalculation for campaigns

Updates campaign booking references

May affect asset availability for other bookings

Use Cases:

Link existing campaigns to confirmed bookings

Bulk associate multiple campaigns with booking

Update campaign associations after booking confirmation

Manage campaign-booking relationships for asset allocation

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Campaigns associated with booking successfully

Body

🟠400Bad Request

🟠404Not Found

🟠409Conflict

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

cURL

Associate single campaignAssociate multiple campaignsAssociate without automatic updates

curl --location --request PATCH 'https://prod.your-api-server.com/booking/456e7890-e89b-12d3-a456-426614174000/campaigns' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "campaignIds": [
        "789cde01-2345-67f8-9012-3456789abcde"
    ],
    "copySegmentationRules": true,
    "updateAssetAllocation": true
}'

Response Example

200 - Successful campaign association

{
    "bookingId": "456e7890-e89b-12d3-a456-426614174000",
    "associatedCampaignIds": [
        "789cde01-2345-67f8-9012-3456789abcde",
        "890def12-3456-78f9-0123-456789abcdef"
    ],
    "totalCampaignIds": [
        "existing-campaign-uuid",
        "789cde01-2345-67f8-9012-3456789abcde",
        "890def12-3456-78f9-0123-456789abcdef"
    ],
    "segmentationRulesCopied": 2,
    "assetAllocationsUpdated": 8,
    "message": "Campaigns associated with booking successfully"
}

Modified at 2025-09-25 10:04:16

Export booking locations as CSV

Remove campaign from booking association