---
title: "Create an ad"
method: POST
path: "/ads/{connection_id}/ad"
tags: ["ads", "ad"]
---

# Create an ad

`POST /ads/{connection_id}/ad`

## Path parameters

- `connection_id` string, required

## Query parameters

- `fields` string[]
- `raw` string

## Request body

- AdsAd
  - `id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `name` string
  - `campaign_id` string
  - `group_id` string
  - `organization_id` string
  - `status` 'UNSPECIFIED' | 'ACTIVE' | 'PAUSED' | 'ARCHIVED' | 'DRAFT' | 'SCHEDULED_FOR_DELETION' | 'PROCESSING' | 'PROCESSING_FAILED'
  - `ad_type` 'TEXT' | 'IMAGE' | 'VIDEO' | 'RESPONSIVE' | 'SHOPPING' | 'APP' | 'CALL' | 'CAROUSEL' | 'SOCIAL' | 'DISPLAY' | 'SEARCH' | 'AUDIO' | 'YOUTUBE' | 'NATIVE' | 'CTV' | 'DOOH'
  - `advertiser_name` string
  - `creative_ids` string[]
  - `creative_asset_url` string
  - `ad_copy` string
  - `headline` string
  - `description` string
  - `cta` string
  - `final_url` string
  - `display_url` string
  - `path1` string
  - `path2` string
  - `promoted` AdsPromoted[]
    - `id` string, required
    - `name` string
    - `type` 'PAGE_ID' | 'APP_ID' | 'STORE_URL' | 'PIXEL_ID' | 'CUSTOM_CONVERSION_ID' | 'CATALOG_ID' | 'PRODUCT_SET_ID' | 'PRIORITIZED_SET_ID' | 'EVENT_ID' | 'OFFER_ID' | 'LEAD_FORM_ID' | 'MESSAGING_CHANNEL_ID' | 'PRODUCT_ID' | 'TWEET_ID' | 'AD_GROUP_TYPE', required
    - `raw` object
  - `logo_creative_id` string
  - `raw` object

## Response `200`

Successful

- AdsAd
  - `id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `name` string
  - `campaign_id` string
  - `group_id` string
  - `organization_id` string
  - `status` 'UNSPECIFIED' | 'ACTIVE' | 'PAUSED' | 'ARCHIVED' | 'DRAFT' | 'SCHEDULED_FOR_DELETION' | 'PROCESSING' | 'PROCESSING_FAILED'
  - `ad_type` 'TEXT' | 'IMAGE' | 'VIDEO' | 'RESPONSIVE' | 'SHOPPING' | 'APP' | 'CALL' | 'CAROUSEL' | 'SOCIAL' | 'DISPLAY' | 'SEARCH' | 'AUDIO' | 'YOUTUBE' | 'NATIVE' | 'CTV' | 'DOOH'
  - `advertiser_name` string
  - `creative_ids` string[]
  - `creative_asset_url` string
  - `ad_copy` string
  - `headline` string
  - `description` string
  - `cta` string
  - `final_url` string
  - `display_url` string
  - `path1` string
  - `path2` string
  - `promoted` AdsPromoted[]
    - `id` string, required
    - `name` string
    - `type` 'PAGE_ID' | 'APP_ID' | 'STORE_URL' | 'PIXEL_ID' | 'CUSTOM_CONVERSION_ID' | 'CATALOG_ID' | 'PRODUCT_SET_ID' | 'PRIORITIZED_SET_ID' | 'EVENT_ID' | 'OFFER_ID' | 'LEAD_FORM_ID' | 'MESSAGING_CHANNEL_ID' | 'PRODUCT_ID' | 'TWEET_ID' | 'AD_GROUP_TYPE', required
    - `raw` object
  - `logo_creative_id` string
  - `raw` object

---

[API](https://skmtc.net/unified/apis/unified-to-api.md) · [All operations](https://skmtc.net/unified/apis/unified-to-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unified/unified-to-api/versions/1f72720916e4/schema)