Actions15
- Account Actions
- Audience Targeting Actions
- Campaign Actions
- Campaign Item Actions
- Report Actions
Campaign → Create
AI-generatedSummary
Creates a new advertising campaign in a specified Taboola account by sending a POST request to the Backstage API.
Inputs
- accountId (required) — The advertiser account ID to create the campaign in.
- campaignName (required) — The name of the new campaign.
- brandingText (required) — The brand name to display with the campaign ads.
- cpc (required) — Cost per click in the account currency (with 2 decimal precision).
- spendingLimit (required) — Total spending limit for the campaign (with 2 decimal precision).
- spendingLimitModel (required) — The spending limit model for the campaign (default: ENTIRE).
- bidStrategy (required) — The bid strategy for the campaign (default: FIXED).
- marketingObjective (required) — The marketing objective for the campaign (default: DRIVE_WEBSITE_TRAFFIC).
- additionalFields — A collection of optional fields including start/end dates, platform targeting, country targeting, active status, app restriction, campaign group ID, daily ad delivery model, daily cap, and tracking code.
Output shape
One or more items, each containing the JSON response from the Taboola API (results array or raw response).
Returns the raw API response, which typically includes the newly created campaign object or a results array of created objects. Paired items are retained from the input.
Examples
Example 1: Create a new brand awareness campaign with a daily budget cap.
Set accountId, campaignName, brandingText, bidStrategy to 'SMART', marketingObjective to 'BRAND_AWARENESS', and configure additionalFields for start_date, end_date, and daily_ad_delivery_model to 'STRICT' with a daily_cap.
Example 2: Create a campaign targeting specific countries and platforms.
Set campaignName, brandingText, cpc, and spendingLimit. Use additionalFields to set country_targeting to comma-separated codes (e.g. 'US,DE') and platform_targeting to an array of platforms (e.g. ['DESK', 'PHON']).