# Campaigns

A campaign has a business objective and organizes *Ad Squads*. You can define a goal and view stats for this campaign to see whether your goal has been reached. The reports and stats combines all the ad squads within this campaign.

### Campaign Attributes[​**](#campaign-attributes "Copy to clipboard")

| Attribute                   | Description                                                                                                                      | Required                                                                                                                                                                                       | Possible Values                                                                                                                                                          |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| ad\_account\_id             | Ad Account ID                                                                                                                    | R                                                                                                                                                                                              |                                                                                                                                                                          |
| daily\_budget\_micro        | Daily Spend Cap (micro-currency)                                                                                                 | O                                                                                                                                                                                              |                                                                                                                                                                          |
| end\_time                   | End time                                                                                                                         | O                                                                                                                                                                                              |                                                                                                                                                                          |
| name                        | Campaign name                                                                                                                    | R                                                                                                                                                                                              | max length: 375 characters                                                                                                                                               |
| start\_time                 | Start time                                                                                                                       | R                                                                                                                                                                                              |                                                                                                                                                                          |
| status                      | Campaign status                                                                                                                  | R                                                                                                                                                                                              | ACTIVE, PAUSED                                                                                                                                                           |
| lifetime\_spend\_cap\_micro | Lifetime spend cap for the campaign (microcurrency)                                                                              | O                                                                                                                                                                                              |                                                                                                                                                                          |
| measurement\_spec           | The apps to be tracked for this campaign                                                                                         | R - Required for tracking installs for campaigns containing these ad types: APP\_INSTALL, DEEP\_LINK, STORY (which swipes up to APP\_INSTALL, DEEP\_LINK) LENS\_APP\_INSTALL, LENS\_DEEP\_LINK | {"ios\_app\_id":"1234", "android\_app\_url":"com.snapchat.android"}                                                                                                      |
| objective                   | Objective of the Campaign                                                                                                        | O                                                                                                                                                                                              | BRAND\_AWARENESS (default), APP\_CONVERSION, APP\_INSTALL, CATALOG\_SALES, ENGAGEMENT, LEAD\_GENERATION, VIDEO\_VIEW, WEB\_CONVERSION, PROMOTE\_STORIES, PROMOTE\_PLACES |
| objective\_v2\_properties   | See table for [Campaign Objective V2 properties](#campaign-objective-v2-properties)                                              | O                                                                                                                                                                                              | See table for Campaign Objective V2 properties                                                                                                                           |
| buy\_model\*\*              | Buy Model                                                                                                                        | O                                                                                                                                                                                              | AUCTION(default), RESERVED                                                                                                                                               |
| reserved\_type\*\*          | Only used for [Reach & Frequency campaigns](/marketing-api/Ads-API/reach-and-frequency.md)                                       | O                                                                                                                                                                                              | REACH\_AND\_FREQUENCY                                                                                                                                                    |
| regulations++               | Required for Campaigns that run Ads for Credit, Housing, Employment (CHE)                                                        | O                                                                                                                                                                                              | { "restricted\_delivery\_signals": true }                                                                                                                                |
| regulations+-               | The candidate / ballot field is optional, but may be required in certain states                                                  | O                                                                                                                                                                                              | { "candidate\_ballot\_information":"Voting rights for dogs" }                                                                                                            |
| delivery\_status            | Delivery status                                                                                                                  | Read-only                                                                                                                                                                                      | See [Delivery status](/marketing-api/Ads-API/delivery-status.md)                                                                                                         |
| mobile\_app\_properties     | Enforces an app install configurations for all the underlying Ad Squads created for the Campaign, this includes SKAd enrollment. | O                                                                                                                                                                                              | See table for [Mobile App Properties](#mobile-app-properties)                                                                                                            |
| shared\_properties          | Used with "Smart budgets", sets a rule for what attributes and values the underlying Ad squads will use.                         | O                                                                                                                                                                                              | See table for [Shared properties](#shared_properties)                                                                                                                    |
| deleted                     | Indicates whether the entity has been deleted or not, only shown when using the parameter `read_deleted_entities`                | Read-only                                                                                                                                                                                      | true                                                                                                                                                                     |
| product\_properties         | Used when a Catalog ID is attached for the purpose of running Dynamic Ads                                                        | O                                                                                                                                                                                              | See [Campaigns in Dynamic Product Ads Guide](/marketing-api/Ads-API/dynamic-product-ads.md#product_properties)                                                           |
| pacing\_level               | Defines where the pacing level is set for the Campaign                                                                           | Optional - See [Smart Budget Campaign level settings](/marketing-api/Ads-API/campaigns.md#smart-budget---campaign-level-settings) for full description                                         | AD\_SQUAD, CAMPAIGN                                                                                                                                                      |
| auto\_bid\_max\_bid\_micro  | This attribute is set automatically when using Smart Budgets                                                                     | Read-only                                                                                                                                                                                      | See [Smart Budget Campaign level settings](/marketing-api/Ads-API/campaigns.md#smart-budget---campaign-level-settings)                                                   |

\*\* See [Reach And Frequency](/marketing-api/Ads-API/reach-and-frequency.md)

++ The regulations attribute alongside restricted\_delivery\_signals is required for Campaigns running Ads promoting Housing, Credit, Employment (HCE), this attribute has to be activated at Ad Account level first or it cannot be used at Campaign level; [](https://businesshelp.snapchat.com/en-US/a/create-ad-account)<https://businesshelp.snapchat.com/en-US/a/create-ad-account>. Ad Squads created within a Campaign promoting HCE has a [limited option of Optimization Goals](/marketing-api/Ads-API/ad-squads.md#squad-optimization-goal-for-housing-credit-employment-hce).

+- The regulations attribute alongside the candidate\_ballot\_information field is optional, but may be required in certain states The paying\_advertiser attribute has to be activated at Ad Account level first or the candidate/ballot field cannot be used at Campaign level; [](https://businesshelp.snapchat.com/en-US/a/create-ad-account)<https://businesshelp.snapchat.com/en-US/a/create-ad-account>

To enable app install and post-install attribution on ads, the `measurement_spec` field must be populated with the corresponding iOS and Android app IDs on campaign creation.

`lifetime_spend_cap_micro` can be increased and removed. Reducing the limit is allowed as long as the new limit is 1.1 times the amount already spent. `daily_budget_micro` set at the campaign level & the new `lifetime_spend_cap_micro` are evaluated independently. Delivery stops when either the Ad Account spend cap or the Campaign Lifetime spend cap is reached.

Micro-currency conversion: 1.00 local currency unit = 1000000 Micro-currency. See [monetary values](/marketing-api/Ads-API/monetary-values.md) for details.

Campaign daily budgets need to be at least 0.25 times sum of all the budgets of their ad squads

In general, campaigns with a RESERVED buy\_model cannot be modified through the API. They must be modified through Snap Ads Manager.

## Mobile App Properties & Attribution logic[​**](#mobile-app-properties--attribution-logic "Copy to clipboard")

The Mobile App property allows advertisers to define an attribution logic with a choice of three different routes:

* Snapchat attribution (Snapchat only)
* [Unified attribution](https://businesshelp.snapchat.com/s/article/unified-attribution) (Mobile Measurement Partner and Snapchat), this route requires that the advertiser uses a correctly configured participating Mobile Measurement Partner. Unified attribution comes with its own report metrics - [Unified attribution metrics](/marketing-api/Ads-API/measurement.md#unified-attribution-metrics)
* SkAdnetwork (SKAN) attribution - SKAN attribution comes with its own report metrics - [SKAd Network Reporting](/marketing-api/Ads-API/measurement.md#skad-network-reporting)

The Unified attribution configuration also allows for an option where SKAN metrics can supplement the Snapchat attribution and Unified attribution.

#### Mobile App Properties[​**](#mobile-app-properties "Copy to clipboard")

The following attributes are used by the property `mobile_app_properties`

| Attribute               | Description                                      | Required                                          | Possible Values                             |
| ----------------------- | ------------------------------------------------ | ------------------------------------------------- | ------------------------------------------- |
| app\_optimization\_type | Indicates the attribution and optimization logic | Required if skad\_network\_status set to ENROLLED | SKAN, UNIFIED, UNIFIED\_WITH\_SKAN\_MEASURE |
| skad\_network\_status   | Indicates enrollment in the SKAdnetwork          | Optional                                          | ENROLLED, NOT\_ENROLLED                     |
| mobile\_app\_id         | ID of the mobile\_app\_id (snap id)              | Required if skad\_network\_status set to ENROLLED |                                             |

Any Ad Squads created under the Campaign need to mirror the mobile\_app\_id (also known as Snap App ID) under the Ad Squad attribute event\_sources. Once set at Campaign level it’s not possible to add Ad Squads specifying a different mobile\_app\_id

There are no changes to the Ad Squads enrolled into the SKAdnetwork, the specification for [SKAdnetwork enrollment are available here](/marketing-api/Ads-API/ad-squads.md#skadnetwork-tracking).

### Attribution logic[​**](#attribution-logic "Copy to clipboard")

This table outlines how to define the attribution logic via the `mobile_app_properties` and the necessary settings at Campaign and Ad Squad level.

Note that for Snapchat attribution optimization the `mobile_app_properties` attribute should be left out.

| Attribution description                                                                                          | app\_optimization\_type      | Campaign settings example                                                                                                                                                    | Ad Squad settings examples                                                                                        |
| ---------------------------------------------------------------------------------------------------------------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| Optimise for Snapchat attribution.                                                                               | -                            | `"mobile_app_properties": {"skad_network_status": "NOT_ENROLLED","mobile_app_id": "78b0a193-5676-4fce-a774-05114e63c321"}`                                                   | -                                                                                                                 |
| Optimise for SKAdNetwork attribution and performance.                                                            | SKAN                         | `"mobile_app_properties": {"skad_network_status": "ENROLLED","mobile_app_id": "78b0a193-5676-4fce-a774-05114e63c321","app_optimization_type": "SKAN"}`                       | `"skadnetwork_properties": {"status": "ENROLLED","ecid_enrollment_status": "ATTACHED","enable_skoverlay": true }` |
| Optimise for unified attribution outcomes across Snapchat and your MMP.                                          | UNIFIED                      | `"mobile_app_properties": {"skad_network_status": "NOT_ENROLLED","mobile_app_id": "07b517bb-9cdb-42ef-ba77-9dd9a9eb2dc1","app_optimization_type": "UNIFIED" }`               | -                                                                                                                 |
| Optimise for unified attribution outcomes across Snapchat and your MMP. Supplement with SKAdNetwork measurement. | UNIFIED\_WITH\_SKAN\_MEASURE | `"mobile_app_properties": {"skad_network_status": "ENROLLED","mobile_app_id": "78b0a193-5676-4fce-a774-05114e63c321","app_optimization_type": "UNIFIED_WITH_SKAN_MEASURE" }` | `"skadnetwork_properties": {"status": "ENROLLED","ecid_enrollment_status": "ATTACHED","enable_skoverlay": true }` |

#### Example - SKAd enrollment via app\_optimization\_type[​**](#example---skad-enrollment-via-app_optimization_type "Copy to clipboard")

These settings enrols the Campaign and all underlying Ad Squads to optimise for SKAdNetwork attribution and performance.

*Campaign settings*

```
{
  "mobile_app_properties": {
    "skad_network_status": "ENROLLED",
    "mobile_app_id": "78b0a193-5676-4fce-a774-05114e63c321",
    "app_optimization_type": "SKAN"
  }
}
```

*Ad Squad settings*

```
{
  "skadnetwork_properties": {
    "status": "ENROLLED",
    "ecid_enrollment_status": "ATTACHED",
    "enable_skoverlay": true
  }
}
```

### Unified Attribution[​**](#unified-attribution "Copy to clipboard")

Unified Attribution combines Snapchat signals with MMP-modeled outcomes and currently supports AppsFlyer and Adjust. Eligibility depends on Ad Account activity and signal readiness, check it with the [eligibility endpoint](/marketing-api/Ads-API/ad-squads.md#snap-app-id---conversion-window-availability) at the Ad Squad level.

After checking eligibility and confirming access, Campaigns can be configured to use Unified attribution by setting the `app_optimization_type` to:

* **UNIFIED**
* **UNIFIED\_WITH\_SKAN\_MEASURE** - Unified Attribution with supplemental SKAdNetwork measurement.

Both options provide additional conversion metrics based on MMP-reported outcomes. Use conversion\_source\_types=app to return app and MMP metrics together for more informations and examples see [Unified Attribution metrics](/marketing-api/Ads-API/measurement.md#unified-attribution-metrics)

### Snap Ads Manager - Business logic[​**](#snap-ads-manager---business-logic "Copy to clipboard")

There is no requirement to use the same business logic as Snap Ads Manager (ads.snapchat.com) but if you wish to mirror this logic it’s outlined in this section.

The `mobile_app_properties` attribute is offered within Campaigns for the below list of `objective_v2_type` options.

| objective\_v2\_type        | Optimization Goals                                                                                                   |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| AWARENESS\_AND\_ENGAGEMENT | As per [Business logic Objective V2](/marketing-api/Ads-API/campaigns.md#business-logic---objective-to-objective_v2) |
| APP\_PROMOTION             | As per [Business logic Objective V2](/marketing-api/Ads-API/campaigns.md#business-logic---objective-to-objective_v2) |
| TRAFFIC                    | As per [Business logic Objective V2](/marketing-api/Ads-API/campaigns.md#business-logic---objective-to-objective_v2) |
| SALES                      | As per [Business logic Objective V2](/marketing-api/Ads-API/campaigns.md#business-logic---objective-to-objective_v2) |

### Validations - Mobile App properties[​**](#validations---mobile-app-properties "Copy to clipboard")

The `mobile_app_properties` at Campaign level introduces several validations in the Marketing API.

| Validation                                                                                                                                                                                    | Campaign attribute                                                           | Ad Squad attribute      | Error message                                                                                                                                                                                                                                               |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| To use Unified conversions logic the Snap App ID needs to include a participating Mobile Measurement Partner, currently limited to APPSFLYER and ADJUST                                       | *app\_optimization\_type* is **UNIFIED** or **UNIFIED\_WITH\_SKAN\_MEASURE** | -                       | *"sub\_request\_error\_reason": "Error code: E38411, message: Mobile app must be valid to use unified app promotion types : \[Mobile app must have one mobile measurement partner to use unified app promotion types]"*                                     |
| The mobile\_app\_id and the event\_sources need to be identical.                                                                                                                              | mobile\_app\_id                                                              | event\_sources          | *"sub\_request\_error\_reason": "Error code: E2941, message: Ad squad SKAdNetwork enrollment status must be consistent with campaign. : \[Campaign mobile app id is CAMPAIGN\_MOBILE\_APP\_ID but adSquad mobile app id is AD\_SQUAD\_EVENT\_SOURCES\_ID]"* |
| The Ad squad attributes are mismatching with the Campaign level settings, the *skadnetwork\_properties* status need to be **ENROLLED** The *ecid\_enrollment\_status* need to be **ATTACHED** | *skad\_network\_status* is **ENROLLED**                                      | skadnetwork\_properties | *"sub\_request\_error\_reason": "Error code: E2941, message: Ad squad SKAdNetwork enrollment status must be consistent with campaign. : \[Campaign skAdNetworkStatus is ENROLLED and AdSquad skAdNetwork Properties is null]"*                              |

## Campaign Objective V2[​**](#campaign-objective-v2 "Copy to clipboard")

The new Campaign level attribute **objective\_v2\_properties** replaces the **objective** attribute, the objective attribute offered users a choice of 12 different Campaign objectives when setting up a Campaign, with the introduction of objective\_v2\_properties this has changed to 5 options.

The objective\_v2\_properties attribute is optional, just as the objective attribute was, and is used only for the business logic surfaced by [Snap Ads Manager](https://businesshelp.snapchat.com/s/article/global-navigation), determining the Optimization Goal options available to Ad Squads. If your application is currently making use of the **objective** attribute, you are expected to start using **objective\_v2\_properties** before 2025.

Along with the launch of objective\_v2\_properties we are also launching a new entity named [Ad Squad Render UI Data](/marketing-api/Ads-API/ad-squad-ui-render-data.md) ( **ad\_squad\_ui\_render\_data** ), this entity has a one-to-one relationship with the Ad Squad entity and is part of the business logic decision tree. The Ad Squad Render UI Data tells the business logic whether the Ad Squad contains ads for WEB, APP, or MIXED in the case of a combination of the two,

### Campaign Objective V2 properties[​**](#campaign-objective-v2-properties "Copy to clipboard")

The following attributes are used by the property *objective\_v2\_properties*

| Attribute           | Description        | Required | Possible Values                                                   |
| ------------------- | ------------------ | -------- | ----------------------------------------------------------------- |
| objective\_v2\_type | The Objective type | O        | AWARENESS\_AND\_ENGAGEMENT, SALES, TRAFFIC, APP\_PROMOTION, LEADS |
| promotion\_type     | The Promotion type | O        | PROMOTE\_PLACES, PROMOTE\_SHOWS, APP\_INSTALL, APP\_REENGAGEMENT  |

### Timelines Objective V2[​**](#timelines-objective-v2 "Copy to clipboard")

| Time                      | Phase                                                                                  | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ------------------------- | -------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| September - December 2024 | Roll-out of objective\_v2\_properties                                                  | The default state for Ads creation in Ads Manager will be the new Advanced creation flow that use objective\_v2\_properties. We will continue to set both the objective and objective\_v2\_properties for Campaigns to ensure that Partner applications can still handle these Campaigns - see table [Snap Ads Manager - objective to objective\_v2](/marketing-api/Ads-API/campaigns.md#snap-ads-manager---objective-to-objective_v2) Applications that make use of the **objective** value are expected to make the transition from **objective** and fully adopt **objective\_v2\_properties** see table [Business logic - objective to objective\_v2](/marketing-api/Ads-API/campaigns.md#business-logic---objective-to-objective_v2) for guidance on the new Business logic. |
| 21 March 2025             | Introduction of translator service from **objective** to **objective\_v2\_properties** | On the 21 March 2025 any application that still creates Campaigns using only the **objective** will have an **objective\_v2\_properties** value applied automatically via our translator service - see table [objective\_v2 - API Campaign creation default behaviour](/marketing-api/Ads-API/campaigns.md#objective_v2---api-campaign-creation-default-behaviour) .                                                                                                                                                                                                                                                                                                                                                                                                              |
| 24 March 2025             | Backfill of **objective\_v2\_properties**                                              | On the 21 March 2025 we will automatically populate the **objective\_v2\_properties** for campaigns that only contain the **objective** value.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

### Business logic - objective to objective\_v2[​**](#business-logic---objective-to-objective_v2 "Copy to clipboard")

This table compares the business logic of the **objective** attribute to the new **objective\_v2\_properties** attribute, this allows 3rd party applicationss to fully or partly follow the same Business Logic that Snap Ads Manager offers.

The left side of the table presents Optimization Goals based on the old objective attribute, the right side of the table presents the Optimization Goals based on objective\_v2\_properties. The **conversion\_location** column refers to the new entity **ad\_squad\_ui\_render\_data** and defines goals offered based on the intended location of conversion, Web, App or Lead form.

Note that validation given SKAd enablement, Dynamic Ads and HCE (Housing Credit Employment) still is applicable to the Optimization Goals available. Read about [HCE and Optimization Goals](/marketing-api/Ads-API/ad-squads.md#squad-optimization-goal-for-housing-credit-employment-hce)

| Previous logic - objective only                          |                                                                                                                                                                                                           | New logic - Campaign objective\_v2\_type - promotion\_type - Ad Squad UI Render Data |                                                       |                             |                                                                                                                                                     |
| -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | ----------------------------------------------------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| objective                                                | optimization goals                                                                                                                                                                                        | objective\_v2\_type                                                                  | promotion\_type                                       | conversion\_location        | optimization goals                                                                                                                                  |
| BRAND\_AWARENESS                                         | IMPRESSIONS, SWIPES, STORY\_OPENS, USES                                                                                                                                                                   | AWARENESS\_AND\_ENGAGEMENT                                                           | -                                                     | -                           | IMPRESSIONS, SWIPES, STORY\_OPENS, USES, VIDEO\_VIEWS, VIDEO\_VIEWS\_15\_SEC                                                                        |
| PROMOTE\_STORIES                                         | IMPRESSIONS                                                                                                                                                                                               | AWARENESS\_AND\_ENGAGEMENT                                                           | PROMOTE\_STORIES\*                                    | -                           | IMPRESSIONS                                                                                                                                         |
| PROMOTE\_PLACES                                          | SWIPES                                                                                                                                                                                                    | AWARENESS\_AND\_ENGAGEMENT                                                           | PROMOTE\_PLACES\*                                     | -                           | SWIPES                                                                                                                                              |
| APP\_CONVERSION                                          | SWIPES, APP\_INSTALLS, APP\_PURCHASE, APP\_SIGNUP, APP\_ADD\_TO\_CART, APP\_LEVEL\_COMPLETE, APP\_ACHIEVEMENT\_UNLOCKED, APP\_AD\_VIEW, APP\_REENGAGE\_PURCHASE, APP\_REENGAGE\_OPEN, LANDING\_PAGE\_VIEW | APP\_PROMOTION                                                                       | APP\_INSTALL                                          | APP                         | IMPRESSIONS, SWIPES, APP\_INSTALLS, APP\_PURCHASE, APP\_SIGNUP, APP\_ADD\_TO\_CART, APP\_LEVEL\_COMPLETE, APP\_ACHIEVEMENT\_UNLOCKED, APP\_AD\_VIEW |
| APP\_CONVERSION with Dynamic Ads                         | SWIPES, APP\_INSTALLS, APP\_PURCHASE, APP\_SIGNUP, APP\_ADD\_TO\_CART, APP\_REENGAGE\_PURCHASE, APP\_REENGAGE\_OPEN                                                                                       | APP\_PROMOTION                                                                       | APP\_INSTALL with Dynamic Ads                         | APP                         | IMPRESSIONS, SWIPES, APP\_INSTALLS, APP\_PURCHASE, APP\_SIGNUP, APP\_ADD\_TO\_CART, APP\_LEVEL\_COMPLETE, APP\_ACHIEVEMENT\_UNLOCKED, APP\_AD\_VIEW |
| APP\_CONVERSION with SKAdNetwork enabled                 | SWIPES, APP\_INSTALLS, APP\_PURCHASE, APP\_SIGNUP, APP\_ADD\_TO\_CART                                                                                                                                     | APP\_PROMOTION                                                                       | APP\_INSTALL with SKAdNetwork enabled                 | APP                         | IMPRESSIONS, SWIPES, APP\_INSTALLS, APP\_PURCHASE, APP\_SIGNUP, APP\_ADD\_TO\_CART                                                                  |
| APP\_CONVERSION with Dynamic Ads and SKAdNetwork enabled | SWIPES, APP\_INSTALLS, APP\_PURCHASE, APP\_SIGNUP                                                                                                                                                         | APP\_PROMOTION                                                                       | APP\_INSTALL with Dynamic Ads and SKAdNetwork enabled | APP                         | IMPRESSIONS, SWIPES, APP\_INSTALLS, APP\_PURCHASE, APP\_SIGNUP, APP\_ADD\_TO\_CART                                                                  |
| WEB\_CONVERSION                                          | SWIPES, STORY\_OPENS, PIXEL\_PAGE\_VIEW, PIXEL\_SIGNUP, PIXEL\_ADD\_TO\_CART, PIXEL\_PURCHASE, PIXEL\_PURCHASE\_VO, LANDING\_PAGE\_VIEW                                                                   | SALES                                                                                | -                                                     | WEB                         | SWIPES, STORY\_OPENS, PIXEL\_PURCHASE, PIXEL\_SIGNUP, PIXEL\_ADD\_TO\_CART, PIXEL\_PAGE\_VIEW, LANDING\_PAGE\_VIEW                                  |
| LEAD\_GENERATION                                         | LEAD\_FORM\_SUBMISSIONS, SWIPES, STORY\_OPENS, PIXEL\_SIGN\_UP                                                                                                                                            | LEADS                                                                                | -                                                     | WEB                         | SWIPES, STORY\_OPENS, PIXEL\_SIGN\_UP, LANDING\_PAGE\_VIEW                                                                                          |
| LEAD\_GENERATION                                         | LEAD\_FORM\_SUBMISSIONS, SWIPES, STORY\_OPENS, PIXEL\_SIGN\_UP                                                                                                                                            | LEADS                                                                                | -                                                     | LEAD\_FORM                  | SWIPES, LEAD\_FORM\_SUBMISSIONS                                                                                                                     |
| -                                                        | -                                                                                                                                                                                                         | LEADS                                                                                | -                                                     | CALL, TEXT                  | IMPRESSIONS, SWIPES                                                                                                                                 |
| APP\_INSTALL                                             | SWIPES, IMPRESSIONS, APP\_INSTALLS, APP\_PURCHASE, APP\_SIGNUP, APP\_ADD\_TO\_CART, APP\_LEVEL\_COMPLETE, APP\_AD\_VIEW                                                                                   | APP\_PROMOTION                                                                       | APP\_INSTALL                                          | -                           | SWIPES, IMPRESSIONS, APP\_INSTALLS, APP\_PURCHASE, APP\_SIGNUP, APP\_ADD\_TO\_CART, APP\_LEVEL\_COMPLETE, APP\_ACHIEVEMENT\_UNLOCKED, APP\_AD\_VIEW |
| APP\_INSTALL with Dynamic Ads                            | SWIPES, IMPRESSIONS, APP\_INSTALLS, APP\_PURCHASE, APP\_SIGNUP, APP\_ADD\_TO\_CART                                                                                                                        | APP\_PROMOTION                                                                       | APP\_INSTALL with Dynamic Ads                         | -                           | SWIPES, IMPRESSIONS, APP\_INSTALLS, APP\_PURCHASE, APP\_SIGNUP, APP\_ADD\_TO\_CART, APP\_LEVEL\_COMPLETE, APP\_ACHIEVEMENT\_UNLOCKED, APP\_AD\_VIEW |
| APP\_INSTALL with SKAdNetwork enabled                    | SWIPES, IMPRESSIONS, APP\_INSTALLS, APP\_PURCHASE, APP\_SIGNUP, APP\_ADD\_TO\_CART                                                                                                                        | APP\_PROMOTION                                                                       | APP\_INSTALL with SKAdNetwork enable                  | -                           | SWIPES, IMPRESSIONS, APP\_INSTALLS, APP\_PURCHASE, APP\_SIGNUP, APP\_ADD\_TO\_CART                                                                  |
| APP\_INSTALL with Dynamic Ads and SKAdNetwork enabled    | SWIPES, IMPRESSIONS, APP\_INSTALLS, APP\_PURCHASE, APP\_SIGNUP, APP\_ADD\_TO\_CART                                                                                                                        | APP\_PROMOTION                                                                       | APP\_INSTALL with Dynamic Ads and SKAdNetwork enabled | -                           | SWIPES, IMPRESSIONS, APP\_INSTALLS, APP\_PURCHASE, APP\_SIGNUP, APP\_ADD\_TO\_CART                                                                  |
| APP\_CONVERSION                                          | SWIPES, APP\_INSTALLS, APP\_PURCHASE, APP\_SIGNUP, APP\_ADD\_TO\_CART, APP\_LEVEL\_COMPLETE, APP\_ACHIEVEMENT\_UNLOCKED, APP\_AD\_VIEW, APP\_REENGAGE\_PURCHASE, APP\_REENGAGE\_OPEN LANDING\_PAGE\_VIEW  | APP\_PROMOTION                                                                       | APP\_REENGAGEMENT                                     | -                           | SWIPES, APP\_REENGAGE\_PURCHASE, APP\_REENGAGE\_OPEN, LANDING\_PAGE\_VIEW                                                                           |
| APP\_CONVERSION with Dynamic Ads                         | SWIPES, APP\_INSTALLS, APP\_PURCHASE, APP\_SIGNUP, APP\_ADD\_TO\_CART                                                                                                                                     | APP\_PROMOTION                                                                       | APP\_REENGAGEMENT with Dynamic Ads                    | -                           | SWIPES, APP\_REENGAGE\_PURCHASE, APP\_REENGAGE\_OPEN, LANDING\_PAGE\_VIEW                                                                           |
| APP\_CONVERSION with SKAdNetwork enabled                 | SWIPES, APP\_INSTALLS, APP\_PURCHASE, APP\_SIGNUP, APP\_ADD\_TO\_CART                                                                                                                                     | APP\_PROMOTION                                                                       | APP\_REENGAGEMENT with SKAdNetwork enabled            | -                           | SWIPES, LANDING\_PAGE\_VIEW                                                                                                                         |
| APP\_CONVERSION with Dynamic Ads and SKAdNetwork enabled | SWIPES, APP\_INSTALLS, APP\_PURCHASE, APP\_SIGNUP, APP\_ADD\_TO\_CART                                                                                                                                     | —                                                                                    | —                                                     | -                           | This combination is not available when using objective\_v2\_type                                                                                    |
| CATALOG\_SALES                                           | SWIPES, STORY\_OPENS, PIXEL\_PURCHASE, PIXEL\_ADD\_TO\_CART, PIXEL\_SIGNUP, PIXEL\_PAGE\_VIEW, PIXEL\_PURCHASE\_VO, LANDING\_PAGE\_VIEW                                                                   | SALES                                                                                | -                                                     | WEB                         | SWIPES, STORY\_OPENS, PIXEL\_PURCHASE, PIXEL\_SIGNUP, PIXEL\_ADD\_TO\_CART, PIXEL\_PAGE\_VIEW, LANDING\_PAGE\_VIEW                                  |
| CATALOG\_SALES                                           | IMPRESSIONS, APP\_INSTALLS, APP\_PURCHASE, APP\_ADD\_TO\_CART, APP\_SIGNUP, APP\_REENGAGE\_PURCHASE, APP\_REENGAGE\_OPEN                                                                                  | SALES                                                                                | -                                                     | APP                         | IMPRESSIONS, SWIPES, APP\_REENGAGE\_PURCHASE APP\_REENGAGE\_OPEN,                                                                                   |
| CATALOG\_SALES with SKAdNetwork enabled                  | IMPRESSIONS, APP\_INSTALLS, APP\_PURCHASE, APP\_ADD\_TO\_CART, APP\_SIGNUP, APP\_REENGAGE\_PURCHASE, APP\_REENGAGE\_OPEN                                                                                  | SALES                                                                                | -                                                     | APP                         | SKAd Network opted-in IMPRESSIONS, SWIPES, STORY\_OPENS                                                                                             |
| CATALOG\_SALES                                           | SWIPES, STORY\_OPENS, PIXEL\_PURCHASE, PIXEL\_ADD\_TO\_CART, PIXEL\_SIGNUP, PIXEL\_PAGE\_VIEW, PIXEL\_PURCHASE\_VO, LANDING\_PAGE\_VIEW                                                                   | SALES                                                                                | -                                                     | WEB                         | SWIPES, STORY\_OPENS, PIXEL\_PURCHASE, PIXEL\_SIGNUP, PIXEL\_ADD\_TO\_CART, PIXEL\_PAGE\_VIEW, LANDING\_PAGE\_VIEW                                  |
| VIDEO\_VIEW                                              | IMPRESSIONS, VIDEO\_VIEWS, VIDEO\_VIEWS\_15\_SEC                                                                                                                                                          | AWARENESS\_AND\_ENGAGEMENT                                                           | -                                                     | -                           | IMPRESSIONS, SWIPES, STORY\_OPENS, USES, VIDEO\_VIEWS, VIDEO\_VIEWS\_15\_SEC                                                                        |
| ENGAGEMENT                                               | SWIPES, USES, STORY\_OPENS, PIXEL\_PURCHASE                                                                                                                                                               | AWARENESS\_AND\_ENGAGEMENT                                                           | -                                                     | -                           | IMPRESSIONS, SWIPES, STORY\_OPENS, USES, VIDEO\_VIEWS, VIDEO\_VIEWS\_15\_SEC                                                                        |
| WEB\_VIEW                                                | SWIPES, PIXEL\_PAGE\_VIEW, LANDING\_PAGE\_VIEW                                                                                                                                                            | TRAFFIC                                                                              | -                                                     | WEB                         | SWIPES, PIXEL\_PAGE\_VIEW, LANDING\_PAGE\_VIEW                                                                                                      |
| APP\_REENGAGEMENT                                        | SWIPES, APP\_REENGAGE\_PURCHASE, APP\_REENGAGE\_OPEN, LANDING\_PAGE\_VIEW                                                                                                                                 | TRAFFIC                                                                              | -                                                     | APP                         | SWIPES, APP\_REENGAGE\_PURCHASE, APP\_REENGAGE\_OPEN, LANDING\_PAGE\_VIEW                                                                           |
| WEB\_VIEW                                                | IMPRESSIONS, SWIPES                                                                                                                                                                                       | TRAFFIC                                                                              | -                                                     | PUBLIC\_PROFILE, CALL, TEXT | IMPRESSIONS, SWIPES                                                                                                                                 |

\*The objectives PROMOTE\_STORIES and PROMOTE\_PLACES are generally not available to create via the API.

### objective\_v2 - API Campaign creation default behaviour[​**](#objective_v2---api-campaign-creation-default-behaviour "Copy to clipboard")

Snap will introduce a translator service which will be used for applications that set only the **objective** attribute on creation of new Campaign entities. This table outlines the default value that will be set by our translator service for applications that have not yet adopted the use of **objective\_v2\_properties** by the 21 March 2025.

| objective         | objective\_v2\_type        |
| ----------------- | -------------------------- |
| PROMOTED\_PLACES  | AWARENESS\_AND\_ENGAGEMENT |
| PROMOTE\_STORIES  | AWARENESS\_AND\_ENGAGEMENT |
| BRAND\_AWARENESS  | AWARENESS\_AND\_ENGAGEMENT |
| APP\_REENGAGEMENT | TRAFFIC                    |
| WEB\_VIEW         | TRAFFIC                    |
| CATALOG\_SALES    | SALES                      |
| APP\_INSTALL      | APP\_PROMOTION             |
| APP\_CONVERSION   | APP\_PROMOTION             |
| WEB\_CONVERSION   | SALES                      |
| LEAD\_GENERATION  | LEADS                      |
| ENGAGEMENT        | AWARENESS\_AND\_ENGAGEMENT |
| VIDEO\_VIEW       | TRAFFIC                    |

## Smart Budgets[​**](#smart-budgets "Copy to clipboard")

The Smart Budgets product allows advertisers to move budget control from the Ad Squad level to the Campaign level, allowing budgets to be moved between Ad Squads dynamically based on where performance will be strongest.

### Campaign level settings[​**](#campaign-level-settings "Copy to clipboard")

When the pacing is set at Campaign level (`“pacing_level”:”CAMPAIGN”`) the attribute `shared_properties` is required on the Campaign and the exact values defined within it need to be mirrored in all Ad Squads that are added to the Campaign. At least one of daily budget (`daily_budget_micro`) or lifetime budget (`lifetime_spend_cap_micro`) is required when using Smart budgets.

Smart Budgets can be used with Campaigns promoting Housing, Credit and Employment (HCE), but currently not with Dynamic Ads.

| Attribute                   | Description                                                                                                                                                                     | Required                                                                            | Possible Values |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------- |
| pacing\_level               | Defines the entity that sets the pacing                                                                                                                                         | R                                                                                   | CAMPAIGN        |
| shared\_properties          | Sets a rule for what attributes and values the underlying Ad squads will use                                                                                                    | R                                                                                   |                 |
| buy\_model                  |                                                                                                                                                                                 | R                                                                                   | AUCTION         |
| daily\_budget\_micro        | Daily Spend Cap (micro-currency)                                                                                                                                                | Optional but one of daily\_budget\_micro or lifetime\_spend\_cap\_micro is required |                 |
| lifetime\_spend\_cap\_micro | Lifetime spend cap for the campaign (microcurrency)                                                                                                                             | Optional but one of lifetime\_spend\_cap\_micro or daily\_budget\_micro is required |                 |
| auto\_bid\_max\_bid\_micro  | This attribute is set automatically when shared\_ad\_squad\_bid\_strategy is using AUTOBID , the value is always set to be the max value of the underlying Ad Squads bid values | Read-only                                                                           |                 |

#### shared\_properties[​**](#shared_properties "Copy to clipboard")

| Attribute                        | Description                                                                                       | Required                                                  | Possible Values                                                  |
| -------------------------------- | ------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | ---------------------------------------------------------------- |
| shared\_conversion\_location     |                                                                                                   | O                                                         | APP, WEB, CALL, TEXT, LEAD\_FORM                                 |
| shared\_conversion\_window       | When used, all Ad Squads under the Campaign need to match their conversion\_window to this value  | O                                                         | Dependent on the bid\_strategy selection - see validations below |
| shared\_optimization\_goal       | When used, all Ad Squads under the Campaign need to match their optimization\_goal to this value. | R                                                         | Dependent on the bid\_strategy selection - see validations below |
| shared\_ad\_squad\_bid\_strategy | When used all Ad Squads under the Campaign needs to match their bid\_strategy to this value       | R                                                         | AUTOBID, LOWEST\_COST\_WITH\_MAX\_BID, TARGET\_COST\*            |
| target\_cost\_in\_micro          |                                                                                                   | O                                                         |                                                                  |
| shared\_pixel\_id                | When used, all Ad Squads under the Campaign need to use this Pixel ID.                            | Required if shared\_optimization\_goal is PIXEL\_PURCHASE | Pixel ID that is accessible to the Ad Account                    |

\*Use the Target Cost check to determine if the Ad Account is eligible to use the bid strategy TARGET\_COST

### Target Cost check[​**](#target-cost-check "Copy to clipboard")

This endpoint determines whethere the Campaign and underlying Ad Squad can make use of the `bid_strategy` value **TARGET\_COST**, the response indicates whether **TARGET\_COST** is valid for the Optimization Goal in question.

| eligibility\_status | Description                                                                               |
| ------------------- | ----------------------------------------------------------------------------------------- |
| ELIGIBLE            | The Optimization Goal qualifies to be used with the bid\_strategy TARGET\_COST            |
| INELIGIBLE          | The Optimization Goal does not yet qualify to be used with the bid\_strategy TARGET\_COST |
| NOT\_APPLICABLE     | This Optimization goal cannot be used with bid\_strategy TARGET\_COST                     |
| UNAVAILABLE         | This response indicates a transient failure.                                              |

#### HTTP Request[​**](#http-request "Copy to clipboard")

`GET https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/sbo_tcpa_eligibility?optimization_goal={optimization_goal}`

#### Request Parameters[​**](#request-parameters "Copy to clipboard")

| Attribute          | Description                                 | Required | Possible values                                                                                                                                                                                                                            |
| ------------------ | ------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| optimization\_goal | Ad Account ID to be checked for Target Cost | R        | PIXEL\_PURCHASE, IMPRESSIONS, LANDING\_PAGE\_VIEW, SWIPES, VIDEO\_VIEWS\_15\_SEC, STORY\_OPENS, USES, LEAD\_FORM\_SUBMISSIONS, APP\_INSTALLS, APP\_PURCHASE, APP\_SIGNUP, APP\_ADD\_TO\_CART, APP\_REENGAGE\_OPEN, APP\_REENGAGE\_PURCHASE |
| ad\_account\_id    | Ad Account ID to be checked for Target Cost | R        |                                                                                                                                                                                                                                            |

#### Example - Smart budget optimization - Target Cost check[​**](#example---smart-budget-optimization---target-cost-check "Copy to clipboard")

This uses the given Optimization goal and Ad Account to check for the eligibility to use the TARGET\_COST bid strategy.

```
curl "GET https://adsapi.snapchat.com/v1/adaccounts/6cb2d391-4bb6-4f67-b025-b25b615362f5/sbo_tcpa_eligibility?optimization_goal=PIXEL_PURCHASE" \
  -H "Authorization: Bearer meowmeowmeow"
```

```
{
  "request_status": "SUCCESS",
  "request_id": "4dce53a0-fa0c-4a15-9a84-a3406838e461",
  "sbo_tcpa_eligibility": {
    "optimization_goal": "PIXEL_PURCHASE",
    "eligibility_status": "ELIGIBLE",
    "id": "6cb2d391-4bb6-4f67-b025-b25b615362f5"
  }
}
```

#### Validations[​**](#validations "Copy to clipboard")

These are the allowed combinations for the Ad Squads that form part of a Smart Budgets set up, these need to be present both in the Campaign shared\_properties and in the Ad Squads.

| shared\_ad\_squad\_bid\_strategy | shared\_optimization\_goal | target\_cost\_in\_micro | shared\_conversion\_window                                                                                                                         |
| -------------------------------- | -------------------------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| AUTOBID                          | IMPRESSIONS                | -                       | -                                                                                                                                                  |
| AUTOBID                          | PIXEL\_PURCHASE            | -                       | As per mapping [optimization\_goal - conversion\_window](/marketing-api/Ads-API/ad-squads.md#optimization-goal-and-conversion-window-combinations) |
| LOWEST\_COST\_WITH\_MAX\_BID     | IMPRESSIONS                | -                       | -                                                                                                                                                  |
| LOWEST\_COST\_WITH\_MAX\_BID     | PIXEL\_PURCHASE            | -                       | As per mapping [optimization\_goal - conversion\_window](/marketing-api/Ads-API/ad-squads.md#optimization-goal-and-conversion-window-combinations) |

### Ad Squad level Attributes (shared)[​**](#ad-squad-level-attributes-shared "Copy to clipboard")

All Ad Squads under the Campaign need to mirror the settings found in the Campaign `shared_properties`. The `shared_properties` does not govern the placement\_v2 or the Ad type, which may differ from Ad Squad to Ad Squad.

The optional min/max constraints on the Ad Squad can be used to control how much each ad squad can spend per day/lifetime.

| Attribute                                  | Description                                                                                                                   | Required   | Possible Values                         |
| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------- | ---------- | --------------------------------------- |
| optimization\_goal                         | Needs to match the value found in `shared_optimization_goal` under the Campaign `shared_properties`                           | R          | PIXEL\_PURCHASE, IMPRESSIONS            |
| conversion\_window                         | Needs to match the value found in shared\_properties on the Campaign level                                                    | R          | SWIPE\_28DAY\_VIEW\_1DAY, SWIPE\_7DAY   |
| bid\_strategy                              | Needs to match the value found in `shared_ad_squad_bid_strategy` under the Campaign `shared_properties`                       | R          | AUTO\_BID, LOWEST\_COST\_WITH\_MAX\_BID |
| pacing\_type                               | Cannot be ACCELERATED                                                                                                         | O          | STANDARD                                |
| daily\_budget\_micro                       | Determined by Campaign `daily_budget_micro`                                                                                   | Set by API |                                         |
| lifetime\_budget\_micro                    | Determined by Campaign `lifetime_spend_cap_micro`                                                                             | Set by API |                                         |
| delivery\_constraint                       | Determined by Campaign budget type, `daily_budget_micro` sets DAILY\_BUDGET, `lifetime_spend_cap_micro` sets LIFETIME\_BUDGET | Set by API | DAILY\_BUDGET, LIFETIME\_BUDGET         |
| start\_time                                | Only required if the Ad Squad uses `lifetime_budget_micro`                                                                    | R          |                                         |
| end\_time                                  | Only required if the Ad Squad uses `lifetime_budget_micro`                                                                    | R          |                                         |
| campaign\_budget\_optimization\_properties | Contains attributes to control daily/lifetime spend                                                                           | O          |                                         |

### Ad Squad - campaign\_budget\_optimization\_properties[​**](#ad-squad---campaign_budget_optimization_properties "Copy to clipboard")

These settings are optional and exist at Ad Squad level under the attribute **campaign\_budget\_optimization\_properties**.

Daily budget constraints can be used when the Campaign uses `daily_budget_micro`, Lifetime constraints can be used when the Campaign uses `lifetime_spend_cap_micro`, daily and lifetime constraints cannot be mixed.

| Attribute                   | Description                                                           | Required | Possible Values |
| --------------------------- | --------------------------------------------------------------------- | -------- | --------------- |
| daily\_min\_spend\_micro    | Minimum daily spend constraint for this ad squad in micro-currency    | O        |                 |
| daily\_max\_spend\_micro    | Maximum daily spend constraint for this ad squad in micro-currency    | O        |                 |
| lifetime\_min\_spend\_micro | Minimum lifetime spend constraint for this ad squad in micro-currency | O        |                 |
| lifetime\_max\_spend\_micro | Maximum lifetime spend constraint for this ad squad in micro-currency | O        |                 |

The `daily_min_spend_micro` must NOT exceed 90% of the campaign's `daily_budget_micro`, the sum of all `daily_min_spend_micro` values across all ad squads in the campaign must NOT exceed the campaign's `daily_budget_micro`.

The `lifetime_min_spend_micro` must NOT exceed 90% of the campaign's `lifetime_spend_cap_micro`, the sum of all `lifetime_min_spend_micro` values across all ad squads in the campaign must NOT exceed the campaign's `lifetime_spend_cap_micro`.

### Snap Ads Manager - Business logic for Smart Budget Optimization[​**](#snap-ads-manager---business-logic-for-smart-budget-optimization "Copy to clipboard")

The following logic is used in Snap Ads Manager to present the user with the combinations that are available when setting up a Campaign, Ad Squad and Ads, this is useful if you wish to mimic the same user journey in your own application.

| Campaign - objective\_v2\_type | optimization\_goal | bid\_strategy                | conversion\_window                      | pixel\_id                      | conversion\_location |
| ------------------------------ | ------------------ | ---------------------------- | --------------------------------------- | ------------------------------ | -------------------- |
| AWARENESS\_AND\_ENGAGEMENT     | IMPRESSIONS        | AUTO\_BID                    | -                                       | -                              | WEB                  |
| AWARENESS\_AND\_ENGAGEMENT     | IMPRESSIONS        | LOWEST\_COST\_WITH\_MAX\_BID | -                                       | -                              | WEB                  |
| APP\_PROMOTION                 | IMPRESSIONS        | AUTO\_BID                    | -                                       | -                              | APP                  |
| APP\_PROMOTION                 | IMPRESSIONS        | LOWEST\_COST\_WITH\_MAX\_BID | -                                       | -                              | APP                  |
| SALES                          | PIXEL\_PURCHASE    | AUTO\_BID                    | \*SWIPE\_28DAY\_VIEW\_1DAY, SWIPE\_7DAY | Pixel ID attached to Ad Squads | WEB                  |
| SALES                          | PIXEL\_PURCHASE    | LOWEST\_COST\_WITH\_MAX\_BID | \*SWIPE\_28DAY\_VIEW\_1DAY, SWIPE\_7DAY | Pixel ID attached to Ad Squads | WEB                  |

\*Use the [Pixel eligibility endpoint](/marketing-api/Ads-API/ad-squads.md#pixel-and-app-optimization-goal-and-conversion-window-eligibility-check) along with Snap Pixel ID to check valid `conversion_window` options.

### Example 1 - Smart Budget Campaign using IMPRESSIONS[​**](#example-1---smart-budget-campaign-using-impressions "Copy to clipboard")

The `pacing_level` is set at the Campaign level, the `shared_properties` are set to enforce the values at the Ad Squad level.

```
 "campaign": {
                "id": "535d4b97-5aad-4fcd-aefc-29866a697ae5",
                "updated_at": "2025-11-07T11:00:35.599Z",
                "created_at": "2025-11-07T11:00:35.577Z",
                "name": "App promotion",
                "ad_account_id": "adfc23e9-627d-46a5-a53c-98bde82bae21",
                "daily_budget_micro": 50000000,
                "status": "ACTIVE",
                "objective": "APP_PROMOTION",
                "measurement_spec": {
                    "ios_app_id": "6502670261",
                    "android_app_url": "com.snap.spectacles.app"
                },
                "start_time": "2025-11-07T10:53:56.017Z",
                "buy_model": "AUCTION",
                "objective_v2_properties": {
                    "objective_v2_type": "APP_PROMOTION",
                    "promotion_type": "APP_INSTALL"
                },
                "pacing_level": "CAMPAIGN",
                "shared_properties": {
                    "shared_optimization_goal": "IMPRESSIONS",
                    "shared_ad_squad_bid_strategy": "LOWEST_COST_WITH_MAX_BID",
                }
            }
```

#### Example 1 - Smart Budget Ad Squad using IMPRESSIONS[​**](#example-1---smart-budget-ad-squad-using-impressions "Copy to clipboard")

The Ad Squad mirrors the values for `optimization_ goal` and `bid_strategy` found in the Campaign `shared_properties`.

```
"adsquad": {
                "id": "4cd00032-9ddd-49bb-808e-850c35b7406e",
                "updated_at": "2025-11-07T11:00:36.953Z",
                "created_at": "2025-11-07T11:00:36.896Z",
                "name": "United Kingdom, All genders and All ages",
                "status": "ACTIVE",
                "campaign_id": "535d4b97-5aad-4fcd-aefc-29866a697ae5",
                "type": "SNAP_ADS",
                "targeting": {
                    "regulated_content": false,
                    "geos": [
                        {
                            "country_code": "uk",
                            "operation": "INCLUDE"
                        }
                    ],
                    "enable_targeting_expansion": true,
                    "auto_expansion_options": {
                        "interest_expansion_option": {
                            "enabled": true
                        },
                        "custom_audience_expansion_option": {
                            "enabled": true
                        }
                    }
                },
                "targeting_reach_status": "VALID",
                "placement_v2": {
                    "config": "AUTOMATIC"
                },
                "bid_micro": 2000000,
                "bid_strategy": "LOWEST_COST_WITH_MAX_BID",
                "daily_budget_micro": 50000000,
                "start_time": "2025-11-07T10:53:56.017Z",
                "optimization_goal": "IMPRESSIONS",
                "delivery_constraint": "DAILY_BUDGET",
                "pacing_type": "STANDARD",
                "brand_safety_config": {
                    "inventory_option": "FULL_INVENTORY"
                }
            }
```

Show more▼

### Example 2 - Smart Budget Campaign using PIXEL\_PURCHASE[​**](#example-2---smart-budget-campaign-using-pixel_purchase "Copy to clipboard")

The `pacing_level` is set at the Campaign level, the `shared_properties` are set to enforce the values at the Ad Squad level. Since the optimization goal is set to *PIXEL\_PURCHASE* the `shared_properties` includes `shared_pixel_id` and `shared_conversion_window`, the conversion window options are determined by the [Pixel eligibility endpoint](/marketing-api/Ads-API/ad-squads.md#pixel-and-app-optimization-goal-and-conversion-window-eligibility-check).

```
"campaign": {
                "id": "c0f1f2b9-5729-4753-bd67-5945df0fea5c",
                "updated_at": "2025-11-07T10:53:27.644Z",
                "created_at": "2025-11-07T10:52:54.622Z",
                "name": "Sales - Smart Budget",
                "ad_account_id": "adfc23e9-627d-46a5-a53c-98bde82bae21",
                "daily_budget_micro": 50000000,
                "status": "ACTIVE",
                "objective": "SALES",
                "start_time": "2025-11-07T10:49:09.403Z",
                "buy_model": "AUCTION",
                "regulations": {
                    "restricted_delivery_signals": false
                },
                "creation_state": "PUBLISHED",
                "objective_v2_properties": {
                    "objective_v2_type": "SALES"
                },
                "pacing_level": "CAMPAIGN",
                "shared_properties": {
                    "shared_conversion_location": "WEB",
                    "shared_conversion_window": "SWIPE_28DAY_VIEW_1DAY",
                    "shared_optimization_goal": "PIXEL_PURCHASE",
                    "shared_ad_squad_bid_strategy": "AUTO_BID",
                    "shared_pixel_id": "f1b73786-8828-4fc1-803f-4f5af6d9082b"
                }
            }
        }
```

#### Example 2 - Smart Budget Ad Squad using PIXEL\_PURCHASE[​**](#example-2---smart-budget-ad-squad-using-pixel_purchase "Copy to clipboard")

The Ad Squad mirrors the values for `optimization_ goal`, `bid_strategy`, `conversion_window` and `pixel_id` found in the Campaign `shared_properties`.

```
"adsquad": {
                "id": "553979ad-a419-4787-a1f1-4dde7f5a1483",
                "updated_at": "2025-11-07T10:52:55.844Z",
                "created_at": "2025-11-07T10:52:55.812Z",
                "name": "United Kingdom, All genders and All ages",
                "status": "ACTIVE",
                "campaign_id": "c0f1f2b9-5729-4753-bd67-5945df0fea5c",
                "type": "SNAP_ADS",
                "targeting": {
                    "regulated_content": false,
                    "geos": [
                        {
                            "country_code": "uk",
                            "operation": "INCLUDE"
                        }
                    ],
                    "enable_targeting_expansion": true,
                    "auto_expansion_options": {
                        "interest_expansion_option": {
                            "enabled": true
                        },
                        "custom_audience_expansion_option": {
                            "enabled": true
                        }
                    }
                },
                "targeting_reach_status": "VALID",
                "placement_v2": {
                    "config": "AUTOMATIC"
                },
                "bid_strategy": "AUTO_BID",
                "daily_budget_micro": 50000000,
                "start_time": "2025-11-07T10:49:09.403Z",
                "optimization_goal": "PIXEL_PURCHASE",
                "conversion_window": "SWIPE_28DAY_VIEW_1DAY",
                "pixel_id": "f1b73786-8828-4fc1-803f-4f5af6d9082b",
                "delivery_constraint": "DAILY_BUDGET",
                "pacing_type": "STANDARD",
                "brand_safety_config": {
                    "inventory_option": "FULL_INVENTORY"
                }
            }
```

Show more▼

### Example 3 - Campaign promoting Housing, Credit and Employment using Smart Budgets[​**](#example-3---campaign-promoting-housing-credit-and-employment-using-smart-budgets "Copy to clipboard")

This campaign is designated as an HCE campaign via the attribute `"regulations": {"restricted_delivery_signals": true}`, in this case combined with the Smart Budget settings defined in the `shared_properties`.

```
            "campaign": {
                "id": "77d08208-8dd7-45d4-ad08-4dc8d21a89d8",
                "updated_at": "2026-08-26T16:18:11.628Z",
                "created_at": "2026-08-26T16:18:11.598Z",
                "name": "Sales CBO with TARGET_COST & HCE enabled",
                "ad_account_id": "f249cfe1-973f-4a04-899a-c1f65b9070a0",
                "daily_budget_micro": 50000000,
                "status": "ACTIVE",
                "objective": "WEB_CONVERSION",
                "start_time": "2025-05-07T17:39:47.154Z",
                "buy_model": "AUCTION",
                "regulations": {
                    "restricted_delivery_signals": true
                },
                "objective_v2_properties": {
                    "objective_v2_type": "SALES"
                },
                "pacing_level": "CAMPAIGN",
                "pacing_properties_version": 0,
                "shared_properties": {
                    "shared_conversion_location": "WEB",
                    "shared_conversion_window": "SWIPE_28DAY_VIEW_1DAY",
                    "shared_optimization_goal": "PIXEL_PURCHASE",
                    "shared_ad_squad_bid_strategy": "AUTO_BID",
                    "shared_pixel_id": "f1b73786-8828-4fc1-803f-4f5af6d9082b"
                }
            }
```

## Create a Campaign[​**](#create-a-campaign "Copy to clipboard")

This endpoint will create a campaign within a specified ad account.

### HTTP Request[​**](#http-request-1 "Copy to clipboard")

`POST https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/campaigns`

### Parameters[​**](#parameters "Copy to clipboard")

| Parameter       | Default | Description   |
| --------------- | ------- | ------------- |
| ad\_account\_id |         | Ad Account ID |

### Example - Create a Campaign[​**](#example---create-a-campaign "Copy to clipboard")

```
curl -X POST \
  -H "Authorization: Bearer meowmeowmeow" \
  -H "Content-Type: application/json" \
   -d '{"campaigns":[{"name":"Badger Tunneling Campaign","ad_account_id":"22225ba6-7559-4000-9663-bace8adff5f2","status":"ACTIVE","start_time":"2025-11-22T21:42:02.392Z","buy_model":"AUCTION","creation_state":"PUBLISHED","objective_v2_properties":{"objective_v2_type":"AWARENESS_AND_ENGAGEMENT"}}]}' \
   "https://adsapi.snapchat.com/v1/adaccounts/{ad_acount_id}/campaigns"
```

> The above command returns JSON structured like this:

```
{
  "request_status": "SUCCESS",
  "request_id": "80366bda-cf18-4969-bf91-843930b9790c",
  "campaigns": [
    {
      "sub_request_status": "SUCCESS",
      "campaign": {
        "id": "7c074b60-3ae7-4975-bc1d-5785cc0be2c8",
        "updated_at": "2025-10-17T20:14:57.012Z",
        "created_at": "2025-10-17T20:14:57.012Z",
        "name": "Badger Tunneling Campaign",
        "ad_account_id": "22225ba6-7559-4000-9663-bace8adff5f2",
        "status": "ACTIVE",
        "objective": "BRAND_AWARENESS",
        "start_time": "2025-11-22T21:42:02.392Z",
        "buy_model": "AUCTION",
        "delivery_status": [
          "INVALID_START_TIME_AFTER_END_TIME",
          "INVALID_START_TIME"
        ],
        "creation_state": "PUBLISHED",
        "objective_v2_properties": {
          "objective_v2_type": "AWARENESS_AND_ENGAGEMENT"
        },
        "pacing_properties_version": 0
      }
    }
  ]
}
```

## Update a Campaign (PUT)[​**](#update-a-campaign-put "Copy to clipboard")

This endpoint will update a specified campaign, see this section for a list of the [attributes that can be added/edited/removed](/marketing-api/Ads-API/campaigns.md#attributes-that-can-be-updated) via the PATCH request.

IMPORTANT! The API expects the entire object when updating any fields. Omitting attributes that have default values will reset those attributes to the default.

There is a limit of 100 campaigns in an Ad Account.

### HTTP Request[​**](#http-request-2 "Copy to clipboard")

`PUT https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/campaigns`

### Parameters[​**](#parameters-1 "Copy to clipboard")

| Parameter       | Default | Description   |
| --------------- | ------- | ------------- |
| ad\_account\_id |         | Ad Account ID |

### Example - Update a Campaign[​**](#example---update-a-campaign "Copy to clipboard")

```
curl -X PUT \
  -H "Authorization: Bearer meowmeowmeow" \
  -H "Content-Type: application/json" \
  -d '{"campaigns": [{"id":"7c074b60-3ae7-4975-bc1d-5785cc0be2c8","name":"Badger Tunneling Campaign","ad_account_id":"22225ba6-7559-4000-9663-bace8adff5f2","status":"PAUSED","objective":"BRAND_AWARENESS","start_time":"2025-11-20T21:45:00","end_time":"2025-11-25T21:45:00","buy_model":"AUCTION","objective_v2_properties":{"objective_v2_type":"AWARENESS_AND_ENGAGEMENT"}}]}'
  https://adsapi.snapchat.com/v1/adaccounts/22225ba6-7559-4000-9663-bace8adff5f2/campaigns
```

> The above command returns JSON structured like this:

```
{
  "request_status": "SUCCESS",
  "request_id": "a848b598-58cf-44a6-b568-c9ef86876499",
  "campaigns": [
    {
      "sub_request_status": "SUCCESS",
      "campaign": {
        "id": "7c074b60-3ae7-4975-bc1d-5785cc0be2c8",
        "updated_at": "2025-10-19T20:25:27.080Z",
        "created_at": "2025-10-17T20:14:57.012Z",
        "name": "Badger Tunneling Campaign",
        "ad_account_id": "22225ba6-7559-4000-9663-bace8adff5f2",
        "status": "PAUSED",
        "objective": "BRAND_AWARENESS",
        "start_time": "2025-11-20T21:45:00.000Z",
        "end_time": "2025-11-25T21:45:00.000Z",
        "buy_model": "AUCTION",
        "delivery_status": [
          "INVALID_START_TIME",
          "INVALID_NOT_ACTIVE",
          "INVALID_NOT_EFFECTIVE_ACTIVE"
        ],
        "creation_state": "PUBLISHED",
        "objective_v2_properties": {
          "objective_v2_type": "AWARENESS_AND_ENGAGEMENT"
        },
        "pacing_properties_version": 0
      }
    }
  ]
}
```

Show more▼

## Patch a Campaign (PATCH)[​**](#patch-a-campaign-patch "Copy to clipboard")

This endpoint partially updates a specified campaign. Only the fields targeted by patch operations are modified; all other fields remain unchanged. See [Patch a Single Entity](/marketing-api/Ads-API/api-patterns.md#patch-a-single-entity) for supported operations and restrictions.

See this section for a list of the [attributes that can be added/edited/removed](/marketing-api/Ads-API/campaigns.md#attributes-that-can-be-updated) via the PATCH request.

### HTTP Request[​**](#http-request-3 "Copy to clipboard")

`PATCH https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/campaigns/{campaign_id}`

### Parameters[​**](#parameters-2 "Copy to clipboard")

| Parameter       | Default | Description   |
| --------------- | ------- | ------------- |
| ad\_account\_id |         | Ad Account ID |
| campaign\_id    |         | Campaign ID   |

### Example 1 - Update the name attribute of a Campaign[​**](#example-1---update-the-name-attribute-of-a-campaign "Copy to clipboard")

```
curl -X PATCH \
  -H "Authorization: Bearer meowmeowmeow" \
  -H "Content-Type: application/json-patch+json" \
  -d '[{"op": "replace", "path": "/name", "value": "Badger Tunneling Campaign V2"}]' \
  https://adsapi.snapchat.com/v1/adaccounts/22225ba6-7559-4000-9663-bace8adff5f2/campaigns/7c074b60-3ae7-4975-bc1d-5785cc0be2c8
```

> The above command returns JSON structured like this:

```
{
  "request_status": "SUCCESS",
  "request_id": "a848b598-58cf-44a6-b568-c9ef86876499",
  "campaigns": [
    {
      "sub_request_status": "SUCCESS",
      "campaign": {
        "id": "7c074b60-3ae7-4975-bc1d-5785cc0be2c8",
        "updated_at": "2025-10-19T20:25:27.080Z",
        "created_at": "2025-10-17T20:14:57.012Z",
        "name": "Badger Tunneling Campaign V2",
        "ad_account_id": "22225ba6-7559-4000-9663-bace8adff5f2",
        "status": "PAUSED",
        "objective": "BRAND_AWARENESS",
        "start_time": "2025-11-20T21:45:00.000Z",
        "end_time": "2025-11-25T21:45:00.000Z",
        "buy_model": "AUCTION"
      }
    }
  ]
}
```

### Example 2 - Adding the Measurement spec to a Campaign[​**](#example-2---adding-the-measurement-spec-to-a-campaign "Copy to clipboard")

```
curl -X PATCH \
  -H "Authorization: Bearer meowmeowmeow" \
  -H "Content-Type: application/json-patch+json" \
  -d '[{"op": "add", "path": "/measurement_spec", "value": {"ios_app_id": "1234567890"}}]' \
  https://adsapi.snapchat.com/v1/adaccounts/22225ba6-7559-4000-9663-bace8adff5f2/campaigns/6a074b60-3ae7-4975-bc1d-5785cc0be3c8
```

> The above command returns JSON structured like this:

```
{
  "request_status": "SUCCESS",
  "request_id": "a848b598-58cf-44a6-b568-c9ef86876499",
  "campaigns": [
    {
      "sub_request_status": "SUCCESS",
      "campaign": {
        "id": "9fc60a2e-3371-47af-a7da-98313f0996a4",
        "updated_at": "2026-05-19T23:58:11.449Z",
        "created_at": "2026-05-19T23:53:06.035Z",
        "name": "Badger Tunneling Campaign V3",
        "ad_account_id": "22225ba6-7559-4000-9663-bace8adff5f2",
        "status": "ACTIVE",
        "objective": "SALES",
        "measurement_spec": {
          "ios_app_id": "1234567890"
        },
        "start_time": "2026-11-26T11:26:58.904Z",
        "buy_model": "AUCTION",
        "objective_v2_properties": {
          "objective_v2_type": "APP_INSTALL"
        }
      }
    }
  ]
}
```

## Campaign - Editable attributes[​**](#campaign---editable-attributes "Copy to clipboard")

These attributes can be updated/added via the PATCH and PUT requests. Attributes that are required (R) cannot be removed from the Campaign, attributes that are optional (O) can be removed from a campaign in most cases.

| Attribute                   | Description                                                                                                                                                                                      | Required | Possible Values                                                   |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- | ----------------------------------------------------------------- |
| name                        | Campaign name                                                                                                                                                                                    | R        | String, max 375 chars                                             |
| status                      | Campaign status                                                                                                                                                                                  | R        | ACTIVE, PAUSED                                                    |
| start\_time                 | Start time                                                                                                                                                                                       | R        | ISO 8601 datetime                                                 |
| end\_time                   | End time                                                                                                                                                                                         | O        | ISO 8601 datetime; must be after start\_time                      |
| daily\_budget\_micro        | Daily Spend Cap (micro-currency)                                                                                                                                                                 | O        | Integer ≥ 20,000,000 (i.e., ≥ $20.00)                             |
| lifetime\_spend\_cap\_micro | Lifetime spend cap for the campaign (micro-currency)                                                                                                                                             | O        | Integer ≥ 20,000,000 (i.e., ≥ $20.00)                             |
| pacing\_level               | Used with “Smart budgets”                                                                                                                                                                        | R        | AD\_SQUAD, CAMPAIGN                                               |
| measurement\_spec           | Apps tracked for install/post-install attribution on ads under this campaign, only required for App Install, Deep Link creatives or Story ads that swipe to App install or deep link attachments | O        | `{"ios_app_id":"1234", "android_app_url":"com.snapchat.android"}` |
| objective\_v2\_properties   | Used for business logic in Snap Ads manager (see sub-fields)                                                                                                                                     | R        | See objective\_v2\_properties sub-fields below                    |
| shared\_properties          | Used with "Smart budgets", partially mutable                                                                                                                                                     | R        | See shared\_properties sub-fields below                           |

**objective\_v2\_properties**

| Attribute           | Description                                 | Required | Possible Values                                                   |
| ------------------- | ------------------------------------------- | -------- | ----------------------------------------------------------------- |
| objective\_v2\_type | Used for business logic in Snap Ads manager | O        | AWARENESS\_AND\_ENGAGEMENT, SALES, TRAFFIC, APP\_PROMOTION, LEADS |
| promotion\_type     | Used for business logic in Snap Ads manager | O        | PROMOTE\_PLACES, PROMOTE\_SHOWS, APP\_INSTALL, APP\_REENGAGEMENT  |

**shared\_properties**

| Attribute               | Description                                            | Required | Possible Values  |
| ----------------------- | ------------------------------------------------------ | -------- | ---------------- |
| target\_cost\_in\_micro | The target cost bid shared by all underlying Ad Squads | R        | Integer (micros) |

## Fetch all Campaigns under an Ad Account[​**](#fetch-all-campaigns-under-an-ad-account "Copy to clipboard")

This endpoint retrieves all Campaigns within a specified ad account, the returned Campaigns can be sorted either in the order they were created or by when they were last updated.

### HTTP Request[​**](#http-request-4 "Copy to clipboard")

`GET https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/campaigns`

### Parameters[​**](#parameters-3 "Copy to clipboard")

| Parameter               | Possible values                    | Description                                                                                                                                                                                                                               |
| ----------------------- | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ad\_account\_id         | Ad Account ID                      |                                                                                                                                                                                                                                           |
| limit                   | 50-1000                            | Parameter for pagination, sets the number of Campaigns returned per page                                                                                                                                                                  |
| sort                    | updated\_at-desc, created\_at-desc | optional parameter, sorts the resulting Campaigns in descending order, either by when they were last updated or by when they were created, this parameter can be combined with limit, but cannot be combined with read\_deleted\_entities |
| read\_deleted\_entities | true                               | optional parameter, this param will return the `deleted` attribute on deleted Campaign entities                                                                                                                                           |

### Example - Fetch all Campaigns under an Ad Account[​**](#example---fetch-all-campaigns-under-an-ad-account "Copy to clipboard")

This request fetches Campaigns returned in the order from when they were last updated.

```
curl "https://adsapi.snapchat.comv1/adaccounts/22225ba6-7559-4000-9663-bace8adff5f2/campaigns?limit=100&sort=updated_at-desc" \
  -H "Authorization: Bearer meowmeowmeow"
```

> The above command returns JSON structured like this:

```
{
    "request_status": "SUCCESS",
    "request_id": "b1c56bf8-ab79-496d-8084-efc322a94172",
    "paging": {
        "next_link": "https://adsapi.snapchat.com/v1/adaccounts/22225ba6-7559-4000-9663-bace8adff5f2/campaigns?cursor=Q2FtcGFpZ25zLzE3ODdjNWRjLTYzOGUtNGJlNS05MTVkLTI5MGU1ZjFhZWVkMQ&limit=100&sort=updated_at-desc"
    },
    "campaigns": [
        {
            "sub_request_status": "SUCCESS",
            "campaign": {
                "id": "c6a9e09a-7126-48e1-96e0-4dbf9ab8d3c2",
                "updated_at": "2024-11-14T19:31:07.019Z",
                "created_at": "2024-11-14T19:31:07.019Z",
                "name": "App Conversions - Porcupines",
                "ad_account_id": "62225ba6-7559-4000-9663-bace8adff5f2",
                "status": "ACTIVE",
                "objective": "APP_CONVERSION",
                "start_time": "2024-11-14T19:11:29.593Z",
                "buy_model": "AUCTION",
                "delivery_status": [
                    "INVALID_UNKNOWN"
                ],
                "creation_state": "PUBLISHED",
                "objective_v2_properties": {
                    "objective_v2_type": "APP_PROMOTION",
                    "is_auto_generated": true
                },
                "pacing_properties_version": 0
            }
        },
        {
            "sub_request_status": "SUCCESS",
            "campaign": {
                "id": "11162f29-85c7-4d43-a037-62d540487e29",
                "updated_at": "2024-11-11T15:14:34.196Z",
                "created_at": "2024-11-11T12:44:10.887Z",
                "name": "Hunter Frogs DPA - Sales",
                "ad_account_id": "62225ba6-7559-4000-9663-bace8adff5f2",
                "status": "ACTIVE",
                "objective": "CATALOG_SALES",
                "start_time": "2024-11-11T12:41:09.808Z",
                "buy_model": "AUCTION",
                "product_properties": {
                    "catalog_id": "85b39b4d-8b29-4309-959c-75a3cbbdcd5b"
                },
                "delivery_status": [
                    "INVALID_UNKNOWN"
                ],
                "creation_state": "PUBLISHED",
                "objective_v2_properties": {
                    "objective_v2_type": "SALES"
                },
                "pacing_properties_version": 0
            }
        },
        {
            "sub_request_status": "SUCCESS",
            "campaign": {
                "id": "cfd35139-35ae-4294-bd58-968ab80d9dc5",
                "updated_at": "2024-11-11T12:46:59.477Z",
                "created_at": "2024-11-11T12:46:59.477Z",
                "name": "New DPA Campaign - Pugs",
                "ad_account_id": "62225ba6-7559-4000-9663-bace8adff5f2",
                "status": "ACTIVE",
                "objective": "CATALOG_SALES",
                "start_time": "2024-11-11T12:46:34.305Z",
                "buy_model": "AUCTION",
                "product_properties": {
                    "catalog_id": "85b39b4d-8b29-4309-959c-75a3cbbdcd5b"
                },
                "delivery_status": [
                    "INVALID_UNKNOWN"
                ],
                "creation_state": "PUBLISHED",
                "objective_v2_properties": {
                    "objective_v2_type": "SALES"
                },
                "pacing_properties_version": 0
            }
        },
    [[[ snip ]]]
        {
            "sub_request_status": "SUCCESS",
            "campaign": {
                "id": "46fb184a-d371-49f0-8384-ea533cef217a",
                "updated_at": "2024-11-08T16:53:54.664Z",
                "created_at": "2021-01-06T10:07:18.915Z",
                "name": "App Install - Badger Campaign",
                "ad_account_id": "62225ba6-7559-4000-9663-bace8adff5f2",
                "status": "PAUSED",
                "objective": "APP_INSTALL",
                "measurement_spec": {
                    "ios_app_id": "324684580",
                    "android_app_url": "com.spotify.music"
                },
                "start_time": "2021-01-06T10:07:14.431Z",
                "buy_model": "AUCTION",
                "delivery_status": [
                    "INVALID_NOT_ACTIVE",
                    "INVALID_NOT_EFFECTIVE_ACTIVE"
                ],
                "creation_state": "PUBLISHED",
                "objective_v2_properties": {
                    "objective_v2_type": "APP_PROMOTION",
                    "is_auto_generated": true
                },
                "pacing_properties_version": 0
            }
        },
        {
            "sub_request_status": "SUCCESS",
            "campaign": {
                "id": "1787c5dc-638e-4be5-915d-290e5f1aeed1",
                "updated_at": "2024-11-08T11:14:21.140Z",
                "created_at": "2024-11-08T11:14:21.140Z",
                "name": "App installs - SKAd - Honeybear",
                "ad_account_id": "62225ba6-7559-4000-9663-bace8adff5f2",
                "status": "ACTIVE",
                "objective": "APP_INSTALL",
                "measurement_spec": {
                    "ios_app_id": "447188370"
                },
                "start_time": "2024-11-08T11:13:09.976Z",
                "buy_model": "AUCTION",
                "delivery_status": [
                    "INVALID_UNKNOWN"
                ],
                "creation_state": "PUBLISHED",
                "objective_v2_properties": {
                    "objective_v2_type": "APP_PROMOTION",
                    "is_auto_generated": true
                },
                "pacing_properties_version": 0
            }
        }
    ]
}
```

Show more▼

## Get a specific Campaign[​**](#get-a-specific-campaign "Copy to clipboard")

This endpoint retrieves a specific campaign.

### HTTP Request[​**](#http-request-5 "Copy to clipboard")

`GET https://adsapi.snapchat.com/v1/campaigns/{campaign_id}`

### URL Parameters[​**](#url-parameters "Copy to clipboard")

| Parameter               | Default | Description                                                                                     |
| ----------------------- | ------- | ----------------------------------------------------------------------------------------------- |
| campaign\_id            |         | Campaign ID                                                                                     |
| read\_deleted\_entities | true    | optional parameter, this param will return the `deleted` attribute on deleted Campaign entities |

### Example - Get a specific Campaign[​**](#example---get-a-specific-campaign "Copy to clipboard")

```
curl "https://adsapi.snapchat.com/v1/campaigns/92e1c28a-a331-45b4-8c26-fd3e0eea8c39" \
  -H "Authorization: Bearer  meowmeowmeow"
```

> The above command returns JSON structured like this:

```
{
  "request_status": "success",
  "request_id": "57b0049c00ff0e8cb21af5199c0001737e616473617069736300016275696c642d35396264653638322d312d31312d3700010107",
  "campaigns": [
    {
      "sub_request_status": "success",
      "campaign": {
        "id": "92e1c28a-a331-45b4-8c26-fd3e0eea8c39",
        "updated_at": "2025-11-14T19:31:07.019Z",
        "created_at": "2025-11-14T19:31:07.019Z",
        "name": "App Conversions - Porcupines",
        "ad_account_id": "62225ba6-7559-4000-9663-bace8adff5f2",
        "status": "ACTIVE",
        "objective": "APP_CONVERSION",
        "start_time": "2025-11-17T19:11:29.593Z",
        "buy_model": "AUCTION",
        "delivery_status": ["DELIVERING"],
        "creation_state": "PUBLISHED",
        "objective_v2_properties": {
          "objective_v2_type": "APP_PROMOTION",
          "is_auto_generated": true
        },
        "pacing_properties_version": 0
      }
    }
  ]
}
```

## Fetch Multiple Campaigns (POST)[​**](#fetch-multiple-campaigns-post "Copy to clipboard")

This endpoint allows you to request up to 2,000 specific Campaigns from the same Ad Account by using the POST request body.

### HTTP Request[​**](#http-request-6 "Copy to clipboard")

`POST https://adsapi.snapchat.com/v1/{ad_account_id}/get_campaigns_by_ids`

### Body Parameters[​**](#body-parameters "Copy to clipboard")

| Parameter   | Description                                             |
| ----------- | ------------------------------------------------------- |
| entity\_ids | Array of up to 2000 entries of `{"id":"{campaign_id}"}` |

### Example - Fetch Multiple Campaigns (POST)[​**](#example---fetch-multiple-campaigns-post "Copy to clipboard")

```
curl -X POST \
  -d '{"entity_ids":[{"id":"75d8dfcc-a012-499e-a376-d9c2f4b4eb04"},{"id":"ef10aa79-eb7b-4d22-95d4-2f137d8e45f4"},{"id":"349e7224-6c24-46f8-9bdd-78a53283c2a0"}]}' \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer meowmeowmeow" \
  https://adsapi.snapchat.com/v1/adaccounts/497979f0-ed17-4971-8288-054883f1cbca/get_campaigns_by_ids
```

> The above command fetches three Campaigns and returns JSON structured like this:

```
{
  "request_status": "SUCCESS",
  "request_id": "6f6bf3c0-0ef4-4112-b8af-499748b9ea0b",
  "campaigns": [
    {
      "sub_request_status": "SUCCESS",
      "campaign": {
        "id": "75d8dfcc-a012-499e-a376-d9c2f4b4eb04",
        "updated_at": "2024-08-09T00:15:28.673Z",
        "created_at": "2024-08-09T00:15:28.673Z",
        "name": "Test co",
        "ad_account_id": "497979f0-ed17-4971-8288-054883f1cbca",
        "status": "ACTIVE",
        "objective": "BRAND_AWARENESS",
        "start_time": "2024-08-09T00:15:02.912Z",
        "buy_model": "AUCTION",
        "delivery_status": [
          "INVALID_EFFECTIVE_INVALID",
          "INVALID_CAMPAIGN_HAS_NO_ACTIVE_AD_SQUAD"
        ],
        "creation_state": "PUBLISHED",
        "objective_v2_properties": {
          "objective_v2_type": "AWARENESS_AND_ENGAGEMENT"
        },
        "pacing_properties_version": 0
      }
    },
    {
      "sub_request_status": "SUCCESS",
      "campaign": {
        "id": "ef10aa79-eb7b-4d22-95d4-2f137d8e45f4",
        "updated_at": "2020-11-20T04:05:59.804Z",
        "created_at": "2020-11-20T04:05:23.948Z",
        "name": "test - Campaign",
        "ad_account_id": "497979f0-ed17-4971-8288-054883f1cbca",
        "status": "PAUSED",
        "objective": "WEB_CONVERSION",
        "start_time": "2020-11-20T04:05:23.003Z",
        "buy_model": "AUCTION",
        "delivery_status": [
          "INVALID_NOT_ACTIVE",
          "INVALID_NOT_EFFECTIVE_ACTIVE",
          "INVALID_CAMPAIGN_HAS_NO_ACTIVE_AD_SQUAD"
        ],
        "creation_state": "PUBLISHED",
        "objective_v2_properties": {
          "objective_v2_type": "SALES",
          "is_auto_generated": true
        },
        "pacing_properties_version": 0
      }
    },
    {
      "sub_request_status": "SUCCESS",
      "campaign": {
        "id": "349e7224-6c24-46f8-9bdd-78a53283c2a0",
        "updated_at": "2022-11-07T23:01:46.607Z",
        "created_at": "2022-11-07T23:01:46.607Z",
        "name": "A/B Test Awareness",
        "ad_account_id": "497979f0-ed17-4971-8288-054883f1cbca",
        "status": "PAUSED",
        "objective": "BRAND_AWARENESS",
        "start_time": "2022-11-07T22:50:44.548Z",
        "buy_model": "AUCTION",
        "delivery_status": [
          "INVALID_NOT_ACTIVE",
          "INVALID_NOT_EFFECTIVE_ACTIVE",
          "INVALID_CAMPAIGN_HAS_NO_ACTIVE_AD_SQUAD"
        ],
        "creation_state": "PUBLISHED",
        "objective_v2_properties": {
          "objective_v2_type": "AWARENESS_AND_ENGAGEMENT",
          "is_auto_generated": true
        },
        "pacing_properties_version": 0
      }
    }
  ]
}
```

Show more▼

## Delete a Specific Campaign[​**](#delete-a-specific-campaign "Copy to clipboard")

```
curl -X DELETE "https://adsapi.snapchat.com/v1/campaigns/92e1c28a-a331-45b4-8c26-fd3e0eea8c39" \
  -H "Authorization: Bearer  meowmeowmeow"
```

> The above command returns JSON structured like this:

```
{
  "request_status": "success",
  "request_id": "57b004dc00ff0e29c26b5d51840001737e616473617069736300016275696c642d35396264653638322d312d31312d3700010106",
  "campaigns": []
}
```

This endpoint deletes a specific campaign.

### HTTP Request[​**](#http-request-7 "Copy to clipboard")

`DELETE https://adsapi.snapchat.com/v1/campaigns/<ID>`

### URL Parameters[​**](#url-parameters-1 "Copy to clipboard")

| Parameter | Description                      |
| --------- | -------------------------------- |
| ID        | The ID of the campaign to delete |
