Managing Advertisers in CAKE

Jeff Olliver

Modified on: Sat, 20 Jun, 2026 at 6:50 PM

This article will cover the following:

What Is an Advertiser?
Creating and Editing Advertiser Profiles
Advertiser Statuses
Billing Cycle Assignment
API: Advertiser Endpoints

What Is an Advertiser?

In CAKE, an advertiser is a company or individual whose products or services are promoted through your network. Every offer in CAKE must be connected to an advertiser — the advertiser record holds the business relationship, billing settings, and contact details.

Creating and Editing Advertiser Profiles

Go to Advertisers in the top navigation and click Add Advertiser.
Enter the Company Name, primary contact name, email address, and phone number.
Set the advertiser's Status.
Assign a Billing Cycle.
Click Save.

Tip:
Changes to a billing cycle take effect on the next billing period. Conversions already recorded in the current period are not retroactively affected.

Advertiser Statuses

Status	What It Means	Effect on Offers
Active	Fully operational.	Offers can run and receive traffic normally.
Inactive	Account exists but not currently running.	Offers linked to this advertiser will not serve traffic.
Pending	Being onboarded or awaiting approval.	Offers may be set up but should not go live yet.
Suspended	Temporarily disabled, often for billing or compliance issues.	All linked offers are paused until resolved.

Caution:
Changing an advertiser to Inactive or Suspended immediately halts traffic to all of their offers. Notify affiliates running those offers before making this change.

Billing Cycle Assignment

Billing Cycle	How It Works
Weekly	Invoices generated every seven days. Common for high-volume accounts.
Bi-Weekly	Invoices generated every two weeks.
Monthly	Invoices generated once per calendar month. Most common default.
Manual	No automatic invoice generation. You create invoices on demand.

API: Advertiser Endpoints

Use the Advertisers API to create and manage advertiser accounts, keeping CAKE in sync with your CRM or onboarding workflows.

List Advertisers

GET /api/2/advertisers.json

Parameter	Type	Required	Description
advertiser_id	integer	No	Filter to a single advertiser by ID.
advertiser_name	string	No	Filter by partial or full name.
advertiser_status	string	No	Filter by status: active, inactive, or pending.
account_manager_id	integer	No	Filter by assigned account manager.
start_at_row	integer	No	Row offset for pagination. Default: 0.
row_limit	integer	No	Max records to return. Default: 25; max: 5000.

Sample request

GET https://yournetwork.cake.com/api/2/advertisers.json
  ?api_key=YOUR_API_KEY
  &advertiser_status=active
  &start_at_row=0
  &row_limit=25

Sample response

{
  "request_status": "Success",
  "advertisers": [{
    "advertiser_id": 101,
    "advertiser_name": "Acme Media Group",
    "advertiser_status": "active",
    "account_manager_id": 5
  }],
  "total_records": 1
}

Create Advertiser

POST /api/2/advertiser.json

Parameter	Type	Required	Description
advertiser_name	string	Yes	Display name for the new advertiser.
account_manager_id	integer	Yes	User ID of the account manager to assign.
advertiser_status	string	No	Initial status. Default: active.
website	string	No	Advertiser's website URL.
billing_cycle_id	integer	No	Billing frequency ID.
country_id	integer	No	CAKE country ID for primary country.
phone	string	No	Contact phone number.