This article will cover the following:
What Notifications CAKE Can Send
CAKE automatically sends email alerts when specific activity thresholds are reached — so you don't have to log in and check manually.
- Offer cap alerts — triggered when conversions, clicks, or revenue approach or reach a defined limit.
- Conversion alerts — sent when conversion volume crosses a threshold you define.
- Payout threshold alerts — sent when payout totals hit a set amount.
- Offer status changes — notify when an offer is paused, activated, or expires.
- Affiliate / advertiser status changes — alert when account status changes.
Note:
The notification types available to you depend on your user role. Account managers typically have access to all notification types. Affiliates and advertisers see notifications relevant to their own activity.
The notification types available to you depend on your user role. Account managers typically have access to all notification types. Affiliates and advertisers see notifications relevant to their own activity.
How to Set Up a Notification
- Go to Admin → Notifications from the top navigation.
- Click Add Notification to open the setup form.
- In the Recipient field, enter the email address(es) that should receive the alert. Separate multiple addresses with commas.
- Choose a Trigger from the dropdown — e.g., "Offer Cap Percentage Reached" or "Conversion Threshold Exceeded."
- Set the Threshold — the number or percentage that fires the alert (e.g., 80 for 80% of cap).
- Select the specific offer the notification applies to, if prompted.
- Click Save. The notification is now active.
Tip:
Set up multiple notifications for the same offer — one at 80% and another at 100% — so you get a warning before the cap is hit, and a confirmation when it is.
Set up multiple notifications for the same offer — one at 80% and another at 100% — so you get a warning before the cap is hit, and a confirmation when it is.
Offer Cap Alerts
| Cap Type | What It Controls | When an Alert Is Useful |
|---|---|---|
| Daily Cap | Maximum conversions per day. | High-volume campaigns that can exhaust a daily budget before end of day. |
| Monthly Cap | Maximum conversions per calendar month. | Budget-controlled campaigns where monthly spend needs to stay within limits. |
| Global Cap | Maximum conversions for the lifetime of the offer. | Limited-run promotions or fixed-budget campaigns. |
- Navigate to Offers and open the offer you want to alert on.
- Go to the Caps tab and confirm the cap is configured. If no cap is set, alerts for that cap type won't fire.
- Return to Admin → Notifications and add a notification using the "Offer Cap Percentage Reached" trigger, linking it to this offer.
Caution:
If an offer has no cap set, cap percentage alerts won't trigger — there's nothing to measure against.
If an offer has no cap set, cap percentage alerts won't trigger — there's nothing to measure against.
Email Alert Configuration
- Recipients — any valid email address, including non-CAKE users such as media buyers or external advertiser contacts.
- Alert frequency — CAKE sends the alert once when the threshold is crossed. It won't repeat on every subsequent conversion. For daily caps, the alert resets each day when the cap resets.
- Deliverability — alerts are sent from your platform's configured system email address. Ask recipients to check spam folders and whitelist the sender address if alerts aren't arriving.
Editing and Deleting Notifications
- Go to Admin → Notifications.
- Find the notification to change. Filter by trigger type or offer to narrow the list.
- To edit: click the notification name or edit icon. Update any field, then click Save.
- To delete: click the delete icon and confirm. Deletion is permanent and cannot be undone.
Caution:
Deleting a notification removes it immediately. If you're unsure whether it's still needed, consider editing the recipient list to a placeholder address rather than deleting it outright.
Deleting a notification removes it immediately. If you're unsure whether it's still needed, consider editing the recipient list to a placeholder address rather than deleting it outright.
API: Notification Endpoints
List Notifications
GET /api/2/notifications.json
| Parameter | Type | Required | Description |
|---|---|---|---|
| notification_id | integer | No | Filter by a specific notification record ID. |
| user_id | integer | No | Filter notifications assigned to a specific user. |
| notification_type_id | integer | No | Filter by notification type category. |
Sample request
GET https://yourdomain.cake.com/api/2/notifications.json
?api_key=YOUR_API_KEY
&user_id=42
¬ification_type_id=3Sample response
{
"request_status": "Success",
"notifications": [{
"notification_id": 8,
"user_id": 42,
"notification_type_id": 3,
"offer_id": 12345,
"threshold_value": 500,
"email_address": "manager@example.com",
"is_active": true
}]
}Create Notification
POST /api/2/notification.json
| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | integer | Yes | ID of the user who owns this notification. |
| notification_type_id | integer | Yes | Integer identifying the type of event that triggers this notification. |
| offer_id | integer | No | Scope the alert to a specific offer. Omit to apply globally. |
| threshold_value | decimal | No | Numeric threshold that triggers the alert (e.g., 500 conversions). |
| email_address | string | No | Email address to receive automated alert messages. |
Sample request
POST https://yourdomain.cake.com/api/2/notification.json
{
"api_key": "YOUR_API_KEY",
"user_id": 42,
"notification_type_id": 3,
"offer_id": 12345,
"threshold_value": 500,
"email_address": "manager@example.com"
}Sample response
{
"request_status": "Success",
"notification": {
"notification_id": 8,
"threshold_value": 500,
"is_active": true
}
}Delete Notification
POST /api/2/delete_notification.json
| Parameter | Type | Required | Description |
|---|---|---|---|
| notification_id | integer | Yes | ID of the notification record to delete. |
Sample request
POST https://yourdomain.cake.com/api/2/delete_notification.json
{
"api_key": "YOUR_API_KEY",
"notification_id": 8
}Sample response
{
"request_status": "Success",
"notification_id": 8,
"deleted": true
}If you have any questions, please reach out to your dedicated CAKE Client Success Manager/Account Manager or contact the CAKE Support Team at support@getCAKE.com.