Skip to content
Docs

Unified ads across Meta, Google, LinkedIn, TikTok, Pinterest, X, Reddit and OpenAI (ChatGPT) Ads: connections, campaigns, ad sets, ads, creatives, insights, targeting, audiences, Google Ads specifics, Ad Library, Reach & Frequency.

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits123 endpointsMCP toolset ads

Connect

Connect ads for a platform

GET/connect/{platform}/ads

Starts an ads connection. Returns the network authorization URL (ads_connect_url), or connects at once (ads_connect_result) when a posting account (account_id) already carries the ads scopes or the connection already exists (unless force).

Access: writeZernio: GET /v1/connect/{platform}/ads

Try it with MCPAsk your agent to call connect-ads (toolset ads)Set up MCP

Path parameters

platformstringrequired

1–40 characters

Query parameters

profile_idstring
account_idstring
login_modestring

classicbusiness

permission_levelstring

fulladvertise

page_idstring
ad_account_idstring
ad_account_idsstring
redirect_urlstring
headlessboolean
forceboolean

Returns object

One of 2 shapes

object: "ads_connect_url" object

objectstring

ads_connect_url

platformstring
login_modestring
urlstring
auth_urlstring
statestring
expires_atstring (date-time) | null

object: "ads_connect_result" object

objectstring

ads_connect_result

statusstring
already_connectedboolean
platformstring
profile_idstring | null
connectionobject
Show 4 child attributes
objectstring

ad_connection

idstring
platformstring
ad_accountsarray of object
ad_accountsarray of object
Show 2 item attributes
objectstring

ad_account

idstring
redirect_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/connect/{platform}/ads
curl "https://api.socialit.com/v1/connect/PLATFORM/ads" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Ads OAuth redirect target

GET/connect/ads/{platform}/callback

Browser redirect target of every ads OAuth flow (Google, TikTok, LinkedIn, Pinterest, Reddit, X, Meta classic). Redirects to the caller redirect_url or the dashboard.

Access: read

Path parameters

platformstringrequired

Query parameters

statestring
codestring
auth_codestring
errorstring
error_descriptionstring
oauth_tokenstring
oauth_verifierstring

Responses

  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/connect/ads/{platform}/callback
curl "https://api.socialit.com/v1/connect/ads/PLATFORM/callback" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"

Complete Meta business login

GET/connect/meta-ads/callback

Facebook Login for Business redirect target (system-user token).

Access: readZernio: GET /v1/connect/meta-ads/callback

Query parameters

statestringrequired
codestring
errorstring

Responses

  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/connect/meta-ads/callback
curl "https://api.socialit.com/v1/connect/meta-ads/callback?state=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"

Set TikTok brand identity

PATCH/connect/tiktok-ads

Access: writeZernio: PATCH /v1/connect/tiktok-ads

Try it with MCPAsk your agent to call set-tiktok-ads-brand-identity (toolset ads)Set up MCP

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

display_namestringrequired

1–40 characters

image_urlstring (uri)required

Returns object

objectstring

tiktok_brand_identity

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/connect/tiktok-ads
curl -X PATCH "https://api.socialit.com/v1/connect/tiktok-ads" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "display_name": "string",
    "image_url": "https://example.com"
  }'
Response · 200

Connect an OpenAI (ChatGPT) Ads account

POST/connect/openai-ads/credentials

Access: writeIdempotency-KeyZernio: POST /v1/connect/openai-ads/credentials

Try it with MCPAsk your agent to call connect-openai-ads (toolset ads)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

api_keystringrequired

8–500 characters

profile_idstring
redirect_urlstring
redirect_uristring
statestring

Returns object

objectstring

ads_connect_result

statusstring
already_connectedboolean
platformstring
profile_idstring | null
connectionobject
Show 4 child attributes
objectstring

ad_connection

idstring
platformstring
ad_accountsarray of object
ad_accountsarray of object
Show 2 item attributes
objectstring

ad_account

idstring
redirect_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/connect/openai-ads/credentials
curl -X POST "https://api.socialit.com/v1/connect/openai-ads/credentials" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "xxxxxxxx",
    "profile_id": "string",
    "redirect_url": "https://example.com",
    "redirect_uri": "https://example.com",
    "state": "string"
  }'
Response · 200

Connect a Whop account

POST/connect/whop-ads/credentials

Access: writeIdempotency-KeyZernio: POST /v1/connect/whop-ads/credentials

Try it with MCPAsk your agent to call connect-whop-ads (toolset ads)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

api_keystringrequired

8–500 characters

profile_idstring
redirect_urlstring
statestring

Returns object

objectstring

ads_connect_result

statusstring
already_connectedboolean
platformstring
profile_idstring | null
connectionobject
Show 4 child attributes
objectstring

ad_connection

idstring
platformstring
ad_accountsarray of object
ad_accountsarray of object
Show 2 item attributes
objectstring

ad_account

idstring
redirect_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/connect/whop-ads/credentials
curl -X POST "https://api.socialit.com/v1/connect/whop-ads/credentials" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "xxxxxxxx",
    "profile_id": "string",
    "redirect_url": "https://example.com",
    "state": "string"
  }'
Response · 200

Connections

List ads connections

GET/ads/connections

Access: read

Try it with MCPAsk your agent to call list-ad-connections (toolset ads)Set up MCP

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

created_atplatformstatus

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

profile_idstring
statusstring

activeneeds_reconnectdisconnected

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
objectstring

ad_connection

idstring
platformstring
ad_accountsarray of object
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/connections
curl "https://api.socialit.com/v1/ads/connections" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Get an ads connection

GET/ads/connections/{id}

Access: read

Try it with MCPAsk your agent to call get-ad-connection (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Returns object

objectstring

ad_connection

idstring
platformstring
ad_accountsarray of object

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/connections/{id}
curl "https://api.socialit.com/v1/ads/connections/ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Disconnect an ads connection

DELETE/ads/connections/{id}

Access: write

Try it with MCPAsk your agent to call delete-ad-connection (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Returns object

objectstring

ad_connection

idstring
deletedboolean
token_revokedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/ads/connections/{id}
curl -X DELETE "https://api.socialit.com/v1/ads/connections/ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Queue an ads sync

POST/ads/connections/{id}/sync

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call sync-ad-connection (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object | null

backfillboolean
ad_account_idsarray of string

Returns object

objectstring

ad_sync

connection_idstring
statusstring
backfillboolean
job_idstring | null

Responses

  • 202Accepted
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/connections/{id}/sync
curl -X POST "https://api.socialit.com/v1/ads/connections/ID/sync" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "backfill": true,
    "ad_account_ids": [
      "string"
    ]
  }'
Response · 202

Ads

List ads

GET/ads

Access: readZernio: GET /v1/ads

Try it with MCPAsk your agent to call list-ads (toolset ads)Set up MCP

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

created_atnamestatusupdated_atspendimpressions

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

from_datestring

pattern ^\d{4}-\d{2}-\d{2}$

to_datestring

pattern ^\d{4}-\d{2}-\d{2}$

sourcestring

allsocialitexternal

statusstring
profile_idstring
campaign_idstring
ad_set_idstring
searchstring
has_deliveryboolean
min_spendnumber
platform_ad_idstring
post_idstring
platform_post_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 40 item attributes
objectstring

ad

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
networkstring | null
campaign_idstring | null
ad_set_idstring | null
campaign_external_idstring | null
ad_set_external_idstring | null
campaign_namestring | null
ad_set_namestring | null
ad_typestring
creative_typestring | null
goalstring | null
review_statusstring | null
rejection_reasonstring | null
creativeobject
post_idstring | null
platform_post_idstring | null
targetingobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null
backfill_pendingboolean

Responses

  • 200OK
  • 202Accepted
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads
curl "https://api.socialit.com/v1/ads" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create an ad (full tree)

POST/ads

Builds campaign → ad set → creative → ad in one call, or attaches to an existing campaign (existing_campaign_id) or ad set (ad_set_id). validate_only: true dry-runs (Meta, Google, OpenAI).

Access: writeIdempotency-KeyZernio: POST /v1/ads/create

Try it with MCPAsk your agent to call create-ad (toolset ads)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

namestringrequired

1–400 characters

campaign_namestring
ad_set_namestring
ad_namestring
goalstring

engagementtrafficawarenessvideo_viewslead_generationlead_conversionconversionsapp_promotioncatalog_salespage_likespage_visitsjob_applicants

existing_campaign_idstring
ad_set_idstring
statusstring

activepaused

campaign_statusstring

activepaused

ad_set_statusstring

activepaused

ad_statusstring

activepaused

budgetobject
Show 2 child attributes
amountnumberrequired
typestringdefault: "daily"

dailylifetime

budget_amountnumber
budget_typestring

dailylifetime

budget_levelstring

campaignad_set

currencystring
start_timestring
end_timestring
bid_strategystring
bid_amountnumber
roas_average_floornumber
optimization_goalstring
billing_eventstring
buying_typestring
rf_prediction_idstring
special_ad_categoriesarray of string
targetingobject

Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or raw (native spec)

creativeobject

CreativeInput: headline, body, description, call_to_action, link_url, image_url, image_hash, video { url | id }, carousel_cards[], existing_creative_id, url_tags, …

creativesarray of object

≤ 50 items

optimize_card_orderboolean

Meta carousels: false keeps your card order (max 5 cards); omit for Meta's default (true). Only with carousel_cards.

page_idstring
instagram_account_idstring
identity_idstring
identity_typestring
organization_idstring
board_idstring
lead_gen_form_idstring
phone_numberstring
campaign_typestring

searchdisplayperformance_maxdemand_genvideo

keywordsarray of object
negative_keywordsarray of object
headlinesarray of any
long_headlinestring
descriptionsarray of any
business_namestring
asset_groupobject
demand_genobject
trackingobject
platform_specific_dataobject
validate_onlyboolean
post_idstring
platform_post_idstring
link_urlstring
bodystring
headlinestring
image_urlstring

Returns object

objectstring

ad_validation

validboolean
platformstring
resultsarray of object

Responses

  • 200OK
  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads
curl -X POST "https://api.socialit.com/v1/ads" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "name": "string",
    "campaign_name": "string"
  }'
Response · 200

Get an ad

GET/ads/{id}

With a Facebook post id (<pageId>_<postId>) and ad_account_id, a placement dark post that maps to no single ad answers ad: null + dark_post; moderate its comments with the same id on /ads/{id}/comments.

Access: readZernio: GET /v1/ads/{adId}

Try it with MCPAsk your agent to call get-ad (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

liveboolean

Returns object

One of 2 shapes

object: "ad" object

objectstring

ad

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
networkstring | null
campaign_idstring | null
ad_set_idstring | null
campaign_external_idstring | null
ad_set_external_idstring | null
campaign_namestring | null
ad_set_namestring | null
ad_typestring
creative_typestring | null
goalstring | null
review_statusstring | null
rejection_reasonstring | null
creativeobject
post_idstring | null
platform_post_idstring | null
targetingobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject

object: "ad_dark_post" object

objectstring

ad_dark_post

idstring
platformstring
adnull
dark_postobject
Show 7 child attributes
platformstring
platform_post_idstring
page_idstring
platform_ad_account_idsarray of string
is_publishedboolean
first_seen_atstring (date-time) | null
last_activity_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/{id}
curl "https://api.socialit.com/v1/ads/ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Update an ad

PATCH/ads/{id}

Access: writeZernio: PUT /v1/ads/{adId}

Try it with MCPAsk your agent to call update-ad (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

namestring
statusstring

activepaused

budgetobject
Show 2 child attributes
amountnumberrequired
typestringdefault: "daily"

dailylifetime

targetingobject

Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or raw (native spec)

creativeobject

CreativeInput: headline, body, description, call_to_action, link_url, image_url, image_hash, video { url | id }, carousel_cards[], existing_creative_id, url_tags, …

headlinesarray of any

≤ 15 items

descriptionsarray of any

≤ 5 items

final_urlsarray of string
asset_groupobject
demand_genobject
page_idstring

Returns object

objectstring

ad

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
networkstring | null
campaign_idstring | null
ad_set_idstring | null
campaign_external_idstring | null
ad_set_external_idstring | null
campaign_namestring | null
ad_set_namestring | null
ad_typestring
creative_typestring | null
goalstring | null
review_statusstring | null
rejection_reasonstring | null
creativeobject
post_idstring | null
platform_post_idstring | null
targetingobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/{id}
curl -X PATCH "https://api.socialit.com/v1/ads/ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "platform": "string",
    "name": "string"
  }'
Response · 200

Delete an ad

DELETE/ads/{id}

Access: writeZernio: DELETE /v1/ads/{adId}

Try it with MCPAsk your agent to call delete-ad (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

Returns object

objectstring

ad

idstring
deletedboolean
archivedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/ads/{id}
curl -X DELETE "https://api.socialit.com/v1/ads/ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Campaigns

List campaigns

GET/ads/campaigns

Access: readZernio: GET /v1/ads/campaigns

Try it with MCPAsk your agent to call list-ad-campaigns (toolset ads)Set up MCP

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

created_atnamestatusupdated_atspendimpressions

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

from_datestring

pattern ^\d{4}-\d{2}-\d{2}$

to_datestring

pattern ^\d{4}-\d{2}-\d{2}$

sourcestring

allsocialitexternal

statusstring
profile_idstring
campaign_idstring
ad_set_idstring
searchstring
has_deliveryboolean
min_spendnumber
include_emptyboolean
liveboolean

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 37 item attributes
objectstring

ad_campaign

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
goalstring | null
objectivestring | null
review_statusstring | null
buying_typestring | null
channel_typestring | null
is_smart_plusboolean
roas_average_floornumber | null
special_ad_categoriesarray of string
ad_set_countinteger
ad_countinteger
settingsobject
issuesarray of object
ad_setsarray of object
Show 36 item attributes
objectstring

ad_set

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
campaign_idstring | null
campaign_external_idstring | null
is_smart_plusboolean
roas_average_floornumber | null
optimization_goalstring | null
billing_eventstring | null
targetingobject
promoted_objectobject | null
learning_phasestring | null
ad_countinteger
settingsobject
adsarray of object
Show 40 item attributes
objectstring

ad

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
networkstring | null
campaign_idstring | null
ad_set_idstring | null
campaign_external_idstring | null
ad_set_external_idstring | null
campaign_namestring | null
ad_set_namestring | null
ad_typestring
creative_typestring | null
goalstring | null
review_statusstring | null
rejection_reasonstring | null
creativeobject
post_idstring | null
platform_post_idstring | null
targetingobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null
backfill_pendingboolean

Responses

  • 200OK
  • 202Accepted
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/campaigns
curl "https://api.socialit.com/v1/ads/campaigns" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a campaign

POST/ads/campaigns

Access: writeIdempotency-KeyZernio: POST /v1/ads/campaigns

Try it with MCPAsk your agent to call create-ad-campaign (toolset ads)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

namestringrequired

1–400 characters

goalstringrequired

engagementtrafficawarenessvideo_viewslead_generationlead_conversionconversionsapp_promotioncatalog_salespage_likespage_visitsjob_applicants

statusstring

activepaused

budgetobject
Show 2 child attributes
amountnumberrequired
typestringdefault: "daily"

dailylifetime

budget_amountnumber
budget_typestring

dailylifetime

budget_levelstring

campaignad_set

buying_typestring

AUCTIONRESERVED

special_ad_categoriesarray of string
special_ad_category_countryarray of string
promoted_objectobject
is_skadnetwork_attributionboolean
start_timestring
end_timestring
bid_strategystring
bid_amountnumber
roas_average_floornumber
portfolio_bid_strategy_idstring
target_impression_shareobject
manual_cpcobject
network_settingsobject
location_targeting_typestring
campaign_typestring

searchdisplayperformance_maxdemand_gen

targetingobject

Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or raw (native spec)

shared_budget_idstring
platform_specific_dataobject
validate_onlyboolean
funding_instrument_idstring

Returns object

objectstring

ad_validation

validboolean
platformstring
resultsarray of object

Responses

  • 200OK
  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/campaigns
curl -X POST "https://api.socialit.com/v1/ads/campaigns" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "name": "string",
    "goal": "engagement"
  }'
Response · 200

Get campaign details

GET/ads/campaigns/{id}

Access: readZernio: GET /v1/ads/campaigns/{campaignId}

Try it with MCPAsk your agent to call get-ad-campaign (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

liveboolean
fieldsstring

Returns object

objectstring

ad_campaign

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
goalstring | null
objectivestring | null
review_statusstring | null
buying_typestring | null
channel_typestring | null
is_smart_plusboolean
roas_average_floornumber | null
special_ad_categoriesarray of string
ad_set_countinteger
ad_countinteger
settingsobject
issuesarray of object
ad_setsarray of object
Show 36 item attributes
objectstring

ad_set

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
campaign_idstring | null
campaign_external_idstring | null
is_smart_plusboolean
roas_average_floornumber | null
optimization_goalstring | null
billing_eventstring | null
targetingobject
promoted_objectobject | null
learning_phasestring | null
ad_countinteger
settingsobject
adsarray of object
Show 40 item attributes
objectstring

ad

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
networkstring | null
campaign_idstring | null
ad_set_idstring | null
campaign_external_idstring | null
ad_set_external_idstring | null
campaign_namestring | null
ad_set_namestring | null
ad_typestring
creative_typestring | null
goalstring | null
review_statusstring | null
rejection_reasonstring | null
creativeobject
post_idstring | null
platform_post_idstring | null
targetingobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/campaigns/{id}
curl "https://api.socialit.com/v1/ads/campaigns/ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Update a campaign

PATCH/ads/campaigns/{id}

Access: writeZernio: PUT /v1/ads/campaigns/{campaignId}

Try it with MCPAsk your agent to call update-ad-campaign (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

namestring

1–400 characters

budgetobject
Show 2 child attributes
amountnumberrequired
typestringdefault: "daily"

dailylifetime

shared_budget_idstring
allow_shared_budget_updateboolean
bid_strategystring
bid_amountnumber
roas_average_floornumber
portfolio_bid_strategy_idstring
target_impression_shareobject
manual_cpcobject
network_settingsobject
tracking_url_templatestring
final_url_suffixstring
start_timestring
end_timestring
spend_capnumber | null
platform_specific_dataobject

Returns object

objectstring

ad_campaign

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
goalstring | null
objectivestring | null
review_statusstring | null
buying_typestring | null
channel_typestring | null
is_smart_plusboolean
roas_average_floornumber | null
special_ad_categoriesarray of string
ad_set_countinteger
ad_countinteger
settingsobject
issuesarray of object
ad_setsarray of object
Show 36 item attributes
objectstring

ad_set

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
campaign_idstring | null
campaign_external_idstring | null
is_smart_plusboolean
roas_average_floornumber | null
optimization_goalstring | null
billing_eventstring | null
targetingobject
promoted_objectobject | null
learning_phasestring | null
ad_countinteger
settingsobject
adsarray of object
Show 40 item attributes
objectstring

ad

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
networkstring | null
campaign_idstring | null
ad_set_idstring | null
campaign_external_idstring | null
ad_set_external_idstring | null
campaign_namestring | null
ad_set_namestring | null
ad_typestring
creative_typestring | null
goalstring | null
review_statusstring | null
rejection_reasonstring | null
creativeobject
post_idstring | null
platform_post_idstring | null
targetingobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/campaigns/{id}
curl -X PATCH "https://api.socialit.com/v1/ads/campaigns/ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "platform": "string",
    "name": "string"
  }'
Response · 200

Delete a campaign

DELETE/ads/campaigns/{id}

Access: writeZernio: DELETE /v1/ads/campaigns/{campaignId}

Try it with MCPAsk your agent to call delete-ad-campaign (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

Returns object

objectstring

ad_campaign

idstring
deletedboolean
archivedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/ads/campaigns/{id}
curl -X DELETE "https://api.socialit.com/v1/ads/campaigns/ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pause or resume a campaign

PATCH/ads/campaigns/{id}/status

Access: writeZernio: PUT /v1/ads/campaigns/{campaignId}/status

Try it with MCPAsk your agent to call set-ad-campaign-status (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

statusstringrequired

activepaused

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

Returns object

objectstring

ad_status_change

levelstring
idstring | null
external_idstring
platformstring
statusstring
platform_statusstring | null
updatedboolean
skippedboolean
skipped_reasonsarray of string

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/campaigns/{id}/status
curl -X PATCH "https://api.socialit.com/v1/ads/campaigns/ID/status" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "status": "active",
    "platform": "string"
  }'
Response · 200

Pause or resume many campaigns

POST/ads/campaigns/bulk-status

Access: writeIdempotency-KeyZernio: POST /v1/ads/campaigns/bulk-status

Try it with MCPAsk your agent to call bulk-set-ad-campaign-status (toolset ads)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

statusstringrequired

activepaused

campaignsarray of objectrequired

1–50 items

Show 3 item attributes
idstringrequired
platformstring
ad_account_idstring

Returns object

objectstring

ad_bulk_status

statusstring
totalsobject
Show 3 child attributes
updatedinteger
skippedinteger
failedinteger
resultsarray of object
Show 7 item attributes
idstring
external_idstring | null
platformstring | null
updatedboolean
skippedboolean
platform_statusstring | null
errorstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/campaigns/bulk-status
curl -X POST "https://api.socialit.com/v1/ads/campaigns/bulk-status" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "active",
    "campaigns": [
      {
        "id": "string",
        "platform": "string"
      }
    ]
  }'
Response · 200

Duplicate a campaign

POST/ads/campaigns/{id}/duplicate

Access: writeIdempotency-KeyZernio: POST /v1/ads/campaigns/{campaignId}/duplicate

Try it with MCPAsk your agent to call duplicate-ad-campaign (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

deep_copyboolean
status_optionstring

pausedactiveinherited

start_timestring
end_timestring
rename_strategystring

noneprefixsuffixdeep_rename

rename_prefixstring
rename_suffixstring
sync_afterboolean
campaign_idstring
ad_set_idstring
reuse_source_creativeboolean

Returns object

objectstring

ad_duplicate

levelstring
source_idstring
copied_external_idstring | null
copied_idstring | null
syncstring
rawobject

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/campaigns/{id}/duplicate
curl -X POST "https://api.socialit.com/v1/ads/campaigns/ID/duplicate" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "platform": "string",
    "deep_copy": true
  }'
Response · 201

Get campaign analytics

GET/ads/campaigns/{id}/analytics

Access: readZernio: GET /v1/ads/campaigns/{campaignId}/analytics

Try it with MCPAsk your agent to call get-ad-campaign-analytics (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

from_datestring

pattern ^\d{4}-\d{2}-\d{2}$

to_datestring

pattern ^\d{4}-\d{2}-\d{2}$

breakdownsstring

Returns object

objectstring

ad_analytics

levelstring
idstring
platformstring
namestring | null
statusstring | null
currencystring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
from_datestring
to_datestring
backfill_pendingboolean
summaryobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
breakdownsobject
unsupported_breakdownsarray of string
breakdown_hintsobject
breakdown_errorsobject
breakdown_dropped_metricsobject
breakdowns_rangeobject | null

Responses

  • 200OK
  • 202Accepted
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/campaigns/{id}/analytics
curl "https://api.socialit.com/v1/ads/campaigns/ID/analytics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Read a campaign's bidding

GET/ads/campaigns/{id}/bidding

Access: readZernio: GET /v1/ads/campaigns/{campaignId}/bidding

Try it with MCPAsk your agent to call get-ad-campaign-bidding (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

customer_idstring

Returns object

objectstring

campaign_bidding

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/campaigns/{id}/bidding
curl "https://api.socialit.com/v1/ads/campaigns/ID/bidding" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Read a campaign's ad schedule

GET/ads/campaigns/{id}/ad-schedule

Access: readZernio: GET /v1/ads/campaigns/{campaignId}/ad-schedule

Try it with MCPAsk your agent to call get-ad-campaign-schedule (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

include_performanceboolean
window_daysinteger

1–90

from_datestring

pattern ^\d{4}-\d{2}-\d{2}$

to_datestring

pattern ^\d{4}-\d{2}-\d{2}$

Returns object

objectstring

ad_schedule

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/campaigns/{id}/ad-schedule
curl "https://api.socialit.com/v1/ads/campaigns/ID/ad-schedule" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Replace a campaign's ad schedule

PUT/ads/campaigns/{id}/ad-schedule

Access: writeZernio: PUT /v1/ads/campaigns/{campaignId}/ad-schedule

Try it with MCPAsk your agent to call replace-ad-campaign-schedule (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

schedulearray of objectrequired

≤ 42 items

Show 6 item attributes
day_of_weekstringrequired

MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY

start_hourintegerrequired

0–23

start_minuteinteger

0153045

end_hourintegerrequired

0–24

end_minuteinteger

0153045

bid_modifiernumber

Returns object

objectstring

ad_schedule

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PUT/ads/campaigns/{id}/ad-schedule
curl -X PUT "https://api.socialit.com/v1/ads/campaigns/ID/ad-schedule" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "platform": "string",
    "schedule": [
      {
        "day_of_week": "MONDAY",
        "start_hour": 0,
        "end_hour": 0
      }
    ]
  }'
Response · 200

Read a Google campaign's targeting

GET/ads/campaigns/{id}/targeting

Access: readZernio: GET /v1/ads/campaigns/{campaignId}/targeting

Try it with MCPAsk your agent to call get-ad-campaign-targeting (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

Returns object

objectstring

campaign_targeting

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/campaigns/{id}/targeting
curl "https://api.socialit.com/v1/ads/campaigns/ID/targeting" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Edit a Google campaign's targeting

PUT/ads/campaigns/{id}/targeting

Access: writeZernio: PUT /v1/ads/campaigns/{campaignId}/targeting

Try it with MCPAsk your agent to call replace-ad-campaign-targeting (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

targetingobjectrequired
Show 4 child attributes
devicesarray of object
locationsarray of object
excluded_locationsarray of object
languagesarray of object

Returns object

objectstring

campaign_targeting

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PUT/ads/campaigns/{id}/targeting
curl -X PUT "https://api.socialit.com/v1/ads/campaigns/ID/targeting" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "platform": "string",
    "targeting": {
      "devices": [
        {}
      ],
      "locations": [
        {}
      ]
    }
  }'
Response · 200

List campaign negative keywords

GET/ads/campaigns/{id}/negative-keywords

Access: readZernio: GET /v1/ads/campaigns/{campaignId}/negative-keywords

Try it with MCPAsk your agent to call list-ad-campaign-negative-keywords (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

negative_keyword

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/campaigns/{id}/negative-keywords
curl "https://api.socialit.com/v1/ads/campaigns/ID/negative-keywords" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Replace campaign negative keywords

PUT/ads/campaigns/{id}/negative-keywords

Access: writeZernio: PUT /v1/ads/campaigns/{campaignId}/negative-keywords

Try it with MCPAsk your agent to call replace-ad-campaign-negative-keywords (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

keywordsarray of objectrequired

≤ 5000 items

Show 2 item attributes
textstringrequired

1–80 characters

match_typestring

exactphrasebroad

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

negative_keyword

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PUT/ads/campaigns/{id}/negative-keywords
curl -X PUT "https://api.socialit.com/v1/ads/campaigns/ID/negative-keywords" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "platform": "string",
    "keywords": [
      {
        "text": "string",
        "match_type": "exact"
      }
    ]
  }'
Response · 200

List campaign negative keyword lists

GET/ads/campaigns/{id}/negative-keyword-lists

Access: readZernio: GET /v1/ads/campaigns/{campaignId}/negative-keyword-lists

Try it with MCPAsk your agent to call list-ad-campaign-negative-keyword-lists (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

negative_keyword_list

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/campaigns/{id}/negative-keyword-lists
curl "https://api.socialit.com/v1/ads/campaigns/ID/negative-keyword-lists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Replace campaign negative keyword lists

PUT/ads/campaigns/{id}/negative-keyword-lists

Access: writeZernio: PUT /v1/ads/campaigns/{campaignId}/negative-keyword-lists

Try it with MCPAsk your agent to call replace-ad-campaign-negative-keyword-lists (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

list_idsarray of stringrequired

≤ 20 items

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

negative_keyword_list

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PUT/ads/campaigns/{id}/negative-keyword-lists
curl -X PUT "https://api.socialit.com/v1/ads/campaigns/ID/negative-keyword-lists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "platform": "string",
    "list_ids": [
      "string"
    ]
  }'
Response · 200

List campaign assets

GET/ads/campaigns/{id}/assets

Access: readZernio: GET /v1/ads/campaigns/{campaignId}/assets

Try it with MCPAsk your agent to call list-ad-campaign-assets (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

customer_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

ad_asset

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/campaigns/{id}/assets
curl "https://api.socialit.com/v1/ads/campaigns/ID/assets" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Attach campaign assets

POST/ads/campaigns/{id}/assets

Access: writeIdempotency-KeyZernio: POST /v1/ads/campaigns/{campaignId}/assets

Try it with MCPAsk your agent to call add-ad-campaign-assets (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

sitelinksarray of object

≤ 50 items

calloutsarray of object

≤ 50 items

structured_snippetsarray of object

≤ 20 items

imagesarray of object

≤ 20 items

customer_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

ad_asset

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/campaigns/{id}/assets
curl -X POST "https://api.socialit.com/v1/ads/campaigns/ID/assets" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "sitelinks": [
      {}
    ],
    "callouts": [
      {}
    ]
  }'
Response · 201

Update campaign assets

PATCH/ads/campaigns/{id}/assets

Access: writeZernio: PUT /v1/ads/campaigns/{campaignId}/assets

Try it with MCPAsk your agent to call update-ad-campaign-assets (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

updatesarray of objectrequired

1–100 items

customer_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

ad_asset

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/campaigns/{id}/assets
curl -X PATCH "https://api.socialit.com/v1/ads/campaigns/ID/assets" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "updates": [
      {}
    ],
    "customer_id": "string"
  }'
Response · 200

Remove campaign assets

DELETE/ads/campaigns/{id}/assets

Access: writeZernio: DELETE /v1/ads/campaigns/{campaignId}/assets

Try it with MCPAsk your agent to call remove-ad-campaign-assets (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

asset_idsstring
link_idsstring
customer_idstring

Returns object

objectstring

ad_asset_removal

removedinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/ads/campaigns/{id}/assets
curl -X DELETE "https://api.socialit.com/v1/ads/campaigns/ID/assets" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Get campaign conversion goals

GET/ads/campaigns/{id}/conversion-goals

Access: readZernio: GET /v1/ads/campaigns/{campaignId}/conversion-goals

Try it with MCPAsk your agent to call get-ad-campaign-conversion-goals (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

Returns object

objectstring

campaign_conversion_goals

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/campaigns/{id}/conversion-goals
curl "https://api.socialit.com/v1/ads/campaigns/ID/conversion-goals" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Update campaign conversion goals

PATCH/ads/campaigns/{id}/conversion-goals

Access: writeZernio: PATCH /v1/ads/campaigns/{campaignId}/conversion-goals

Try it with MCPAsk your agent to call update-ad-campaign-conversion-goals (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

goalsarray of object

≤ 50 items

Show 3 item attributes
categorystringrequired
originstringrequired
biddablebooleanrequired
goal_config_levelstring

customercampaign

custom_conversion_goal_idstring | null

Returns object

objectstring

campaign_conversion_goals

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/campaigns/{id}/conversion-goals
curl -X PATCH "https://api.socialit.com/v1/ads/campaigns/ID/conversion-goals" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "platform": "string",
    "goals": [
      {
        "category": "string",
        "origin": "string",
        "biddable": true
      }
    ]
  }'
Response · 200

List Performance Max asset groups

GET/ads/campaigns/{id}/asset-groups

Access: readZernio: GET /v1/ads/campaigns/{campaignId}/asset-groups

Try it with MCPAsk your agent to call list-ad-asset-groups (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

asset_group

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/campaigns/{id}/asset-groups
curl "https://api.socialit.com/v1/ads/campaigns/ID/asset-groups" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a Performance Max asset group

POST/ads/campaigns/{id}/asset-groups

Access: writeIdempotency-KeyZernio: POST /v1/ads/campaigns/{campaignId}/asset-groups

Try it with MCPAsk your agent to call create-ad-asset-group (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

namestringrequired

1–255 characters

final_urlsarray of stringrequired

≥ 1 items

final_mobile_urlsarray of string
path1string
path2string
statusstring

enabledpaused

assetsobject
listing_group_filterobject
validate_onlyboolean

Returns object

objectstring

ad_validation

validboolean
platformstring
resultsarray of object

Responses

  • 200OK
  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/campaigns/{id}/asset-groups
curl -X POST "https://api.socialit.com/v1/ads/campaigns/ID/asset-groups" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "name": "string",
    "final_urls": [
      "string"
    ]
  }'
Response · 200

Get a Performance Max asset group

GET/ads/campaigns/{id}/asset-groups/{assetGroupId}

Access: readZernio: GET /v1/ads/campaigns/{campaignId}/asset-groups/{assetGroupId}

Try it with MCPAsk your agent to call get-ad-asset-group (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

assetGroupIdstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

Returns object

objectstring

asset_group

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/campaigns/{id}/asset-groups/{assetGroupId}
curl "https://api.socialit.com/v1/ads/campaigns/ID/asset-groups/ASSET_GROUP_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Update a Performance Max asset group

PATCH/ads/campaigns/{id}/asset-groups/{assetGroupId}

Access: writeZernio: PATCH /v1/ads/campaigns/{campaignId}/asset-groups/{assetGroupId}

Try it with MCPAsk your agent to call update-ad-asset-group (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

assetGroupIdstringrequired

1–300 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

namestring
statusstring

enabledpaused

final_urlsarray of string
final_mobile_urlsarray of string
path1string
path2string
validate_onlyboolean

Returns object

objectstring

asset_group

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/campaigns/{id}/asset-groups/{assetGroupId}
curl -X PATCH "https://api.socialit.com/v1/ads/campaigns/ID/asset-groups/ASSET_GROUP_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "platform": "string",
    "name": "string"
  }'
Response · 200

Remove a Performance Max asset group

DELETE/ads/campaigns/{id}/asset-groups/{assetGroupId}

Access: writeZernio: DELETE /v1/ads/campaigns/{campaignId}/asset-groups/{assetGroupId}

Try it with MCPAsk your agent to call delete-ad-asset-group (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

assetGroupIdstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

validate_onlyboolean

Returns object

objectstring

asset_group

idstring
deletedboolean
archivedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/ads/campaigns/{id}/asset-groups/{assetGroupId}
curl -X DELETE "https://api.socialit.com/v1/ads/campaigns/ID/asset-groups/ASSET_GROUP_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
POST/ads/campaigns/{id}/asset-groups/{assetGroupId}/assets

Access: writeIdempotency-KeyZernio: POST /v1/ads/campaigns/{campaignId}/asset-groups/{assetGroupId}/assets

Try it with MCPAsk your agent to call link-ad-asset-group-assets (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

assetGroupIdstringrequired

1–300 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

linkarray of object

≤ 100 items

unlinkarray of object

≤ 100 items

validate_onlyboolean

Returns object

objectstring

asset_group

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/campaigns/{id}/asset-groups/{assetGroupId}/assets
curl -X POST "https://api.socialit.com/v1/ads/campaigns/ID/asset-groups/ASSET_GROUP_ID/assets" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "platform": "string",
    "link": [
      {}
    ]
  }'
Response · 200

Replace an asset group's listing-group tree

PUT/ads/campaigns/{id}/asset-groups/{assetGroupId}/listing-group-filters

Access: writeZernio: PUT /v1/ads/campaigns/{campaignId}/asset-groups/{assetGroupId}/listing-group-filters

Try it with MCPAsk your agent to call replace-ad-listing-group-filters (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

assetGroupIdstringrequired

1–300 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

treeobjectrequired
validate_onlyboolean

Returns object

objectstring

listing_group_tree

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PUT/ads/campaigns/{id}/asset-groups/{assetGroupId}/listing-group-filters
curl -X PUT "https://api.socialit.com/v1/ads/campaigns/ID/asset-groups/ASSET_GROUP_ID/listing-group-filters" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "platform": "string",
    "tree": {}
  }'
Response · 200

Ad sets

List ad sets

GET/ads/ad-sets

Access: readZernio: GET /v1/ads/ad-sets

Try it with MCPAsk your agent to call list-ad-sets (toolset ads)Set up MCP

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

created_atnamestatusupdated_atspendimpressions

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

from_datestring

pattern ^\d{4}-\d{2}-\d{2}$

to_datestring

pattern ^\d{4}-\d{2}-\d{2}$

sourcestring

allsocialitexternal

statusstring
profile_idstring
campaign_idstring
ad_set_idstring
searchstring
has_deliveryboolean
min_spendnumber
liveboolean

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 36 item attributes
objectstring

ad_set

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
campaign_idstring | null
campaign_external_idstring | null
is_smart_plusboolean
roas_average_floornumber | null
optimization_goalstring | null
billing_eventstring | null
targetingobject
promoted_objectobject | null
learning_phasestring | null
ad_countinteger
settingsobject
adsarray of object
Show 40 item attributes
objectstring

ad

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
networkstring | null
campaign_idstring | null
ad_set_idstring | null
campaign_external_idstring | null
ad_set_external_idstring | null
campaign_namestring | null
ad_set_namestring | null
ad_typestring
creative_typestring | null
goalstring | null
review_statusstring | null
rejection_reasonstring | null
creativeobject
post_idstring | null
platform_post_idstring | null
targetingobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null
backfill_pendingboolean

Responses

  • 200OK
  • 202Accepted
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/ad-sets
curl "https://api.socialit.com/v1/ads/ad-sets" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create an ad set

POST/ads/ad-sets

Access: writeIdempotency-KeyZernio: POST /v1/ads/ad-sets

Try it with MCPAsk your agent to call create-ad-set (toolset ads)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

campaign_idstringrequired
namestringrequired

1–400 characters

statusstring

activepaused

budgetobject
Show 2 child attributes
amountnumberrequired
typestringdefault: "daily"

dailylifetime

bid_amountnumber
max_cpcnumber
bid_strategystring
optimization_goalstring
billing_eventstring
targetingobject

Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or raw (native spec)

start_timestring
end_timestring
promoted_objectobject
customer_idstring
platform_specific_dataobject

Returns object

objectstring

ad_set

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
campaign_idstring | null
campaign_external_idstring | null
is_smart_plusboolean
roas_average_floornumber | null
optimization_goalstring | null
billing_eventstring | null
targetingobject
promoted_objectobject | null
learning_phasestring | null
ad_countinteger
settingsobject
adsarray of object
Show 40 item attributes
objectstring

ad

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
networkstring | null
campaign_idstring | null
ad_set_idstring | null
campaign_external_idstring | null
ad_set_external_idstring | null
campaign_namestring | null
ad_set_namestring | null
ad_typestring
creative_typestring | null
goalstring | null
review_statusstring | null
rejection_reasonstring | null
creativeobject
post_idstring | null
platform_post_idstring | null
targetingobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/ad-sets
curl -X POST "https://api.socialit.com/v1/ads/ad-sets" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "campaign_id": "string",
    "name": "string"
  }'
Response · 201

Get ad set details

GET/ads/ad-sets/{id}

Access: readZernio: GET /v1/ads/ad-sets/{adSetId}

Try it with MCPAsk your agent to call get-ad-set (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

liveboolean
fieldsstring

Returns object

objectstring

ad_set

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
campaign_idstring | null
campaign_external_idstring | null
is_smart_plusboolean
roas_average_floornumber | null
optimization_goalstring | null
billing_eventstring | null
targetingobject
promoted_objectobject | null
learning_phasestring | null
ad_countinteger
settingsobject
adsarray of object
Show 40 item attributes
objectstring

ad

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
networkstring | null
campaign_idstring | null
ad_set_idstring | null
campaign_external_idstring | null
ad_set_external_idstring | null
campaign_namestring | null
ad_set_namestring | null
ad_typestring
creative_typestring | null
goalstring | null
review_statusstring | null
rejection_reasonstring | null
creativeobject
post_idstring | null
platform_post_idstring | null
targetingobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/ad-sets/{id}
curl "https://api.socialit.com/v1/ads/ad-sets/ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Update an ad set

PATCH/ads/ad-sets/{id}

Access: writeZernio: PUT /v1/ads/ad-sets/{adSetId}

Try it with MCPAsk your agent to call update-ad-set (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

namestring
statusstring

activepaused

budgetobject
Show 2 child attributes
amountnumberrequired
typestringdefault: "daily"

dailylifetime

bid_strategystring
bid_amountnumber
roas_average_floornumber
smart_targetingboolean
targetingobject

Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or raw (native spec)

start_timestring
end_timestring
value_rule_set_idstring
value_rules_appliedboolean
optimization_goalstring
platform_specific_dataobject

Returns object

objectstring

ad_set

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
campaign_idstring | null
campaign_external_idstring | null
is_smart_plusboolean
roas_average_floornumber | null
optimization_goalstring | null
billing_eventstring | null
targetingobject
promoted_objectobject | null
learning_phasestring | null
ad_countinteger
settingsobject
adsarray of object
Show 40 item attributes
objectstring

ad

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
networkstring | null
campaign_idstring | null
ad_set_idstring | null
campaign_external_idstring | null
ad_set_external_idstring | null
campaign_namestring | null
ad_set_namestring | null
ad_typestring
creative_typestring | null
goalstring | null
review_statusstring | null
rejection_reasonstring | null
creativeobject
post_idstring | null
platform_post_idstring | null
targetingobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/ad-sets/{id}
curl -X PATCH "https://api.socialit.com/v1/ads/ad-sets/ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "platform": "string",
    "name": "string"
  }'
Response · 200

Delete an ad set

DELETE/ads/ad-sets/{id}

Access: writeZernio: DELETE /v1/ads/ad-sets/{adSetId}

Try it with MCPAsk your agent to call delete-ad-set (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

Returns object

objectstring

ad_set

idstring
deletedboolean
archivedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/ads/ad-sets/{id}
curl -X DELETE "https://api.socialit.com/v1/ads/ad-sets/ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pause or resume an ad set

PATCH/ads/ad-sets/{id}/status

Access: writeZernio: PUT /v1/ads/ad-sets/{adSetId}/status

Try it with MCPAsk your agent to call set-ad-set-status (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

statusstringrequired

activepaused

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

Returns object

objectstring

ad_status_change

levelstring
idstring | null
external_idstring
platformstring
statusstring
platform_statusstring | null
updatedboolean
skippedboolean
skipped_reasonsarray of string

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/ad-sets/{id}/status
curl -X PATCH "https://api.socialit.com/v1/ads/ad-sets/ID/status" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "status": "active",
    "platform": "string"
  }'
Response · 200

Duplicate an ad set

POST/ads/ad-sets/{id}/duplicate

Access: writeIdempotency-KeyZernio: POST /v1/ads/ad-sets/{adSetId}/duplicate

Try it with MCPAsk your agent to call duplicate-ad-set (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

deep_copyboolean
status_optionstring

pausedactiveinherited

start_timestring
end_timestring
rename_strategystring

noneprefixsuffixdeep_rename

rename_prefixstring
rename_suffixstring
sync_afterboolean
campaign_idstring
ad_set_idstring
reuse_source_creativeboolean

Returns object

objectstring

ad_duplicate

levelstring
source_idstring
copied_external_idstring | null
copied_idstring | null
syncstring
rawobject

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/ad-sets/{id}/duplicate
curl -X POST "https://api.socialit.com/v1/ads/ad-sets/ID/duplicate" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "platform": "string",
    "deep_copy": true
  }'
Response · 201

List ad-group assets

GET/ads/ad-sets/{id}/assets

Access: readZernio: GET /v1/ads/ad-sets/{adSetId}/assets

Try it with MCPAsk your agent to call list-ad-set-assets (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

customer_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

ad_asset

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/ad-sets/{id}/assets
curl "https://api.socialit.com/v1/ads/ad-sets/ID/assets" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Attach ad-group assets

POST/ads/ad-sets/{id}/assets

Access: writeIdempotency-KeyZernio: POST /v1/ads/ad-sets/{adSetId}/assets

Try it with MCPAsk your agent to call add-ad-set-assets (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

sitelinksarray of object

≤ 50 items

calloutsarray of object

≤ 50 items

structured_snippetsarray of object

≤ 20 items

imagesarray of object

≤ 20 items

customer_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

ad_asset

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/ad-sets/{id}/assets
curl -X POST "https://api.socialit.com/v1/ads/ad-sets/ID/assets" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "sitelinks": [
      {}
    ],
    "callouts": [
      {}
    ]
  }'
Response · 201

Update ad-group assets

PATCH/ads/ad-sets/{id}/assets

Access: writeZernio: PUT /v1/ads/ad-sets/{adSetId}/assets

Try it with MCPAsk your agent to call update-ad-set-assets (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

updatesarray of objectrequired

1–100 items

customer_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

ad_asset

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/ad-sets/{id}/assets
curl -X PATCH "https://api.socialit.com/v1/ads/ad-sets/ID/assets" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "updates": [
      {}
    ],
    "customer_id": "string"
  }'
Response · 200

Remove ad-group assets

DELETE/ads/ad-sets/{id}/assets

Access: writeZernio: DELETE /v1/ads/ad-sets/{adSetId}/assets

Try it with MCPAsk your agent to call remove-ad-set-assets (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

asset_idsstring
link_idsstring
customer_idstring

Returns object

objectstring

ad_asset_removal

removedinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/ads/ad-sets/{id}/assets
curl -X DELETE "https://api.socialit.com/v1/ads/ad-sets/ID/assets" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Tree

Get the campaign tree

GET/ads/tree

Access: readZernio: GET /v1/ads/tree

Try it with MCPAsk your agent to call get-ad-tree (toolset ads)Set up MCP

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

created_atnamestatusupdated_atspendimpressions

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

from_datestring

pattern ^\d{4}-\d{2}-\d{2}$

to_datestring

pattern ^\d{4}-\d{2}-\d{2}$

sourcestring

allsocialitexternal

statusstring
profile_idstring
campaign_idstring
ad_set_idstring
searchstring
has_deliveryboolean
min_spendnumber
updated_sincestring
dailyboolean
daily_levelstring
time_incrementstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 37 item attributes
objectstring

ad_campaign

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
goalstring | null
objectivestring | null
review_statusstring | null
buying_typestring | null
channel_typestring | null
is_smart_plusboolean
roas_average_floornumber | null
special_ad_categoriesarray of string
ad_set_countinteger
ad_countinteger
settingsobject
issuesarray of object
ad_setsarray of object
Show 36 item attributes
objectstring

ad_set

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
campaign_idstring | null
campaign_external_idstring | null
is_smart_plusboolean
roas_average_floornumber | null
optimization_goalstring | null
billing_eventstring | null
targetingobject
promoted_objectobject | null
learning_phasestring | null
ad_countinteger
settingsobject
adsarray of object
Show 40 item attributes
objectstring

ad

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
statusstring
configured_statusstring | null
platform_statusstring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
currencystring | null
bid_strategystring | null
bid_amountnumber | null
start_timestring (date-time) | null
end_timestring (date-time) | null
is_externalboolean
metricsobject | null
Show 20 child attributes
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
currencystring | null
last_synced_atstring (date-time) | null
platform_created_atstring (date-time) | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
networkstring | null
campaign_idstring | null
ad_set_idstring | null
campaign_external_idstring | null
ad_set_external_idstring | null
campaign_namestring | null
ad_set_namestring | null
ad_typestring
creative_typestring | null
goalstring | null
review_statusstring | null
rejection_reasonstring | null
creativeobject
post_idstring | null
platform_post_idstring | null
targetingobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null
backfill_pendingboolean

Responses

  • 200OK
  • 202Accepted
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/tree
curl "https://api.socialit.com/v1/ads/tree" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Timeline

Get daily account metrics

GET/ads/timeline

Access: readZernio: GET /v1/ads/timeline

Try it with MCPAsk your agent to call get-ad-timeline (toolset ads)Set up MCP

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

from_datestring

pattern ^\d{4}-\d{2}-\d{2}$

to_datestring

pattern ^\d{4}-\d{2}-\d{2}$

Returns object

objectstring

ad_timeline

currencystring | null
from_datestring
to_datestring
backfill_pendingboolean
dataarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject

Responses

  • 200OK
  • 202Accepted
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/timeline
curl "https://api.socialit.com/v1/ads/timeline" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Boost

Boost a post as an ad

POST/ads/boost

Access: writeIdempotency-KeyZernio: POST /v1/ads/boost

Try it with MCPAsk your agent to call boost-ad-post (toolset ads)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

namestringrequired

1–400 characters

campaign_namestring
ad_set_namestring
ad_namestring
goalstringrequired

engagementtrafficawarenessvideo_viewslead_generationlead_conversionconversionsapp_promotioncatalog_salespage_likespage_visitsjob_applicants

existing_campaign_idstring
ad_set_idstring
statusstring

activepaused

campaign_statusstring

activepaused

ad_set_statusstring

activepaused

ad_statusstring

activepaused

budgetobject
Show 2 child attributes
amountnumberrequired
typestringdefault: "daily"

dailylifetime

budget_amountnumber
budget_typestring

dailylifetime

budget_levelstring

campaignad_set

currencystring
start_timestring
end_timestring
bid_strategystring
bid_amountnumber
roas_average_floornumber
optimization_goalstring
billing_eventstring
buying_typestring
rf_prediction_idstring
special_ad_categoriesarray of string
targetingobject

Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or raw (native spec)

creativeobject

CreativeInput: headline, body, description, call_to_action, link_url, image_url, image_hash, video { url | id }, carousel_cards[], existing_creative_id, url_tags, …

creativesarray of object

≤ 50 items

optimize_card_orderboolean

Meta carousels: false keeps your card order (max 5 cards); omit for Meta's default (true). Only with carousel_cards.

page_idstring
instagram_account_idstring
identity_idstring
identity_typestring
organization_idstring
board_idstring
lead_gen_form_idstring
phone_numberstring
campaign_typestring

searchdisplayperformance_maxdemand_genvideo

keywordsarray of object
negative_keywordsarray of object
headlinesarray of any
long_headlinestring
descriptionsarray of any
business_namestring
asset_groupobject
demand_genobject
trackingobject
platform_specific_dataobject
validate_onlyboolean
post_idstring
platform_post_idstring
link_urlstring
bodystring
headlinestring
image_urlstring
destination_typestring

WEBSITEMESSENGERINSTAGRAM_DIRECT

spark_auth_codestring
call_to_actionstring

Returns object

objectstring

ad_validation

validboolean
platformstring
resultsarray of object

Responses

  • 200OK
  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/boost
curl -X POST "https://api.socialit.com/v1/ads/boost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "name": "string",
    "goal": "engagement"
  }'
Response · 200

Messaging

Create a click-to-message ad

POST/ads/messaging

Access: writeIdempotency-KeyZernio: POST /v1/ads/messaging

Try it with MCPAsk your agent to call create-messaging-ad (toolset ads)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

namestringrequired

1–400 characters

campaign_namestring
ad_set_namestring
ad_namestring
goalstring

engagementtrafficawarenessvideo_viewslead_generationlead_conversionconversionsapp_promotioncatalog_salespage_likespage_visitsjob_applicants

existing_campaign_idstring
ad_set_idstring
statusstring

activepaused

campaign_statusstring

activepaused

ad_set_statusstring

activepaused

ad_statusstring

activepaused

budgetobject
Show 2 child attributes
amountnumberrequired
typestringdefault: "daily"

dailylifetime

budget_amountnumber
budget_typestring

dailylifetime

budget_levelstring

campaignad_set

currencystring
start_timestring
end_timestring
bid_strategystring
bid_amountnumber
roas_average_floornumber
optimization_goalstring
billing_eventstring
buying_typestring
rf_prediction_idstring
special_ad_categoriesarray of string
targetingobject

Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or raw (native spec)

creativeobject

CreativeInput: headline, body, description, call_to_action, link_url, image_url, image_hash, video { url | id }, carousel_cards[], existing_creative_id, url_tags, …

creativesarray of object

≤ 50 items

optimize_card_orderboolean

Meta carousels: false keeps your card order (max 5 cards); omit for Meta's default (true). Only with carousel_cards.

page_idstring
instagram_account_idstring
identity_idstring
identity_typestring
organization_idstring
board_idstring
lead_gen_form_idstring
phone_numberstring
campaign_typestring

searchdisplayperformance_maxdemand_genvideo

keywordsarray of object
negative_keywordsarray of object
headlinesarray of any
long_headlinestring
descriptionsarray of any
business_namestring
asset_groupobject
demand_genobject
trackingobject
platform_specific_dataobject
validate_onlyboolean
post_idstring
platform_post_idstring
link_urlstring
bodystring
headlinestring
image_urlstring
destinationstringrequired

messengerinstagram_direct

welcome_messageobject
workflow_idstring

Returns object

objectstring

ad_validation

validboolean
platformstring
resultsarray of object

Responses

  • 200OK
  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/messaging
curl -X POST "https://api.socialit.com/v1/ads/messaging" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "name": "string",
    "destination": "messenger"
  }'
Response · 200

Call

Create a click-to-call ad

POST/ads/call

Access: writeIdempotency-KeyZernio: POST /v1/ads/call

Try it with MCPAsk your agent to call create-call-ad (toolset ads)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

namestringrequired

1–400 characters

campaign_namestring
ad_set_namestring
ad_namestring
goalstring

engagementtrafficawarenessvideo_viewslead_generationlead_conversionconversionsapp_promotioncatalog_salespage_likespage_visitsjob_applicants

existing_campaign_idstring
ad_set_idstring
statusstring

activepaused

campaign_statusstring

activepaused

ad_set_statusstring

activepaused

ad_statusstring

activepaused

budgetobject
Show 2 child attributes
amountnumberrequired
typestringdefault: "daily"

dailylifetime

budget_amountnumber
budget_typestring

dailylifetime

budget_levelstring

campaignad_set

currencystring
start_timestring
end_timestring
bid_strategystring
bid_amountnumber
roas_average_floornumber
optimization_goalstring
billing_eventstring
buying_typestring
rf_prediction_idstring
special_ad_categoriesarray of string
targetingobject

Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or raw (native spec)

creativeobject

CreativeInput: headline, body, description, call_to_action, link_url, image_url, image_hash, video { url | id }, carousel_cards[], existing_creative_id, url_tags, …

creativesarray of object

≤ 50 items

optimize_card_orderboolean

Meta carousels: false keeps your card order (max 5 cards); omit for Meta's default (true). Only with carousel_cards.

page_idstring
instagram_account_idstring
identity_idstring
identity_typestring
organization_idstring
board_idstring
lead_gen_form_idstring
phone_numberstringrequired
campaign_typestring

searchdisplayperformance_maxdemand_genvideo

keywordsarray of object
negative_keywordsarray of object
headlinesarray of any
long_headlinestring
descriptionsarray of any
business_namestring
asset_groupobject
demand_genobject
trackingobject
platform_specific_dataobject
validate_onlyboolean
post_idstring
platform_post_idstring
link_urlstring
bodystring
headlinestring
image_urlstring
call_to_actionstring

Returns object

objectstring

ad_validation

validboolean
platformstring
resultsarray of object

Responses

  • 200OK
  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/call
curl -X POST "https://api.socialit.com/v1/ads/call" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "name": "string",
    "phone_number": "+15551234567"
  }'
Response · 200

Status

Pause or resume an ad

PATCH/ads/{id}/status

Access: writeZernio: PUT /v1/ads/{adId}/status

Try it with MCPAsk your agent to call set-ad-status (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

statusstringrequired

activepaused

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

Returns object

objectstring

ad_status_change

levelstring
idstring | null
external_idstring
platformstring
statusstring
platform_statusstring | null
updatedboolean
skippedboolean
skipped_reasonsarray of string

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/{id}/status
curl -X PATCH "https://api.socialit.com/v1/ads/ID/status" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "status": "active",
    "platform": "string"
  }'
Response · 200

Duplicate

Duplicate an ad

POST/ads/{id}/duplicate

Access: writeIdempotency-KeyZernio: POST /v1/ads/{adId}/duplicate

Try it with MCPAsk your agent to call duplicate-ad (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

deep_copyboolean
status_optionstring

pausedactiveinherited

start_timestring
end_timestring
rename_strategystring

noneprefixsuffixdeep_rename

rename_prefixstring
rename_suffixstring
sync_afterboolean
campaign_idstring
ad_set_idstring
reuse_source_creativeboolean

Returns object

objectstring

ad_duplicate

levelstring
source_idstring
copied_external_idstring | null
copied_idstring | null
syncstring
rawobject

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/{id}/duplicate
curl -X POST "https://api.socialit.com/v1/ads/ID/duplicate" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "platform": "string",
    "deep_copy": true
  }'
Response · 201

Analytics

Get ad analytics

GET/ads/{id}/analytics

Access: readZernio: GET /v1/ads/{adId}/analytics

Try it with MCPAsk your agent to call get-ad-analytics (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

from_datestring

pattern ^\d{4}-\d{2}-\d{2}$

to_datestring

pattern ^\d{4}-\d{2}-\d{2}$

breakdownsstring

Returns object

objectstring

ad_analytics

levelstring
idstring
platformstring
namestring | null
statusstring | null
currencystring | null
budgetobject | null
Show 4 child attributes
amountnumber | null
typestring
levelstring
shared_budget_idstring | null
from_datestring
to_datestring
backfill_pendingboolean
summaryobject
dailyarray of object
Show 19 item attributes
datestring
spendnumber | null
impressionsnumber | null
reachnumber | null
frequencynumber | null
clicksnumber | null
link_clicksnumber | null
ctrnumber | null
cpcnumber | null
cpmnumber | null
engagementnumber | null
video_viewsnumber | null
conversionsnumber | null
conversion_valuenumber | null
cost_per_conversionnumber | null
roasnumber | null
leadsnumber | null
actionsobject
action_valuesobject
breakdownsobject
unsupported_breakdownsarray of string
breakdown_hintsobject
breakdown_errorsobject
breakdown_dropped_metricsobject
breakdowns_rangeobject | null

Responses

  • 200OK
  • 202Accepted
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/{id}/analytics
curl "https://api.socialit.com/v1/ads/ID/analytics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Preview

Render previews of an ad

GET/ads/{id}/preview

Access: readZernio: GET /v1/ads/{adId}/preview

Try it with MCPAsk your agent to call get-ad-previews (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

formatsstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

ad_preview

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/{id}/preview
curl "https://api.socialit.com/v1/ads/ID/preview" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Render pre-create ad previews

POST/ads/preview

Access: readZernio: POST /v1/ads/preview

Try it with MCPAsk your agent to call preview-ad-creative (toolset ads)Set up MCP

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

formatsarray of string
existing_creative_idstring
creativeobject

CreativeInput: headline, body, description, call_to_action, link_url, image_url, image_hash, video { url | id }, carousel_cards[], existing_creative_id, url_tags, …

creative_specobject
page_idstring
instagram_account_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

ad_preview

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/preview
curl -X POST "https://api.socialit.com/v1/ads/preview" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "formats": [
      "string"
    ],
    "existing_creative_id": "string"
  }'
Response · 200

Review

Read an ad's review verdict

GET/ads/{id}/review

Access: readZernio: GET /v1/ads/{adId}/review

Try it with MCPAsk your agent to call get-ad-review (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

Returns object

objectstring

ad_review

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/{id}/review
curl "https://api.socialit.com/v1/ads/ID/review" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Media

Direct URLs of an ad's media

GET/ads/{id}/media

Access: readZernio: GET /v1/ads/{adId}/media

Try it with MCPAsk your agent to call get-ad-media (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

Returns object

objectstring

ad_media

ad_idstring | null
platformstring
mediaarray of object

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/{id}/media
curl "https://api.socialit.com/v1/ads/ID/media" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Creatives

Creative library

GET/ads/creatives

Access: readZernio: GET /v1/ads/creatives

Try it with MCPAsk your agent to call list-ad-creatives (toolset ads)Set up MCP

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

limitinteger

1–100

afterstring
fieldsstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

ad_creative

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null
next_cursorstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/creatives
curl "https://api.socialit.com/v1/ads/creatives" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a standalone creative

POST/ads/creatives

Access: writeIdempotency-KeyZernio: POST /v1/ads/creatives

Try it with MCPAsk your agent to call create-ad-creative (toolset ads)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

namestring
page_idstring
instagram_account_idstring
headlinestringrequired
bodystringrequired
descriptionstring
call_to_actionstring
link_urlstringrequired
optimize_card_orderboolean
image_urlstring
image_hashstring
videoobject
carousel_cardsarray of object

≤ 10 items

url_tagsstring
promotionobject
creative_featuresobject
multi_advertiserboolean
ai_disclosureobject

Returns object

objectstring

ad_creative

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/creatives
curl -X POST "https://api.socialit.com/v1/ads/creatives" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "headline": "string",
    "body": "string",
    "link_url": "https://example.com"
  }'
Response · 201

Creative details

GET/ads/creatives/{creativeId}

Access: readZernio: GET /v1/ads/creatives/{creativeId}

Try it with MCPAsk your agent to call get-ad-creative (toolset ads)Set up MCP

Path parameters

creativeIdstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

fieldsstring
thumbnail_widthinteger
thumbnail_heightinteger

Returns object

objectstring

ad_creative

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/creatives/{creativeId}
curl "https://api.socialit.com/v1/ads/creatives/CREATIVE_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Rename a creative

PATCH/ads/creatives/{creativeId}

Access: writeZernio: PUT /v1/ads/creatives/{creativeId}

Try it with MCPAsk your agent to call rename-ad-creative (toolset ads)Set up MCP

Path parameters

creativeIdstringrequired

1–300 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

namestringrequired

1–400 characters

Returns object

objectstring

ad_creative

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/creatives/{creativeId}
curl -X PATCH "https://api.socialit.com/v1/ads/creatives/CREATIVE_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "name": "string"
  }'
Response · 200

Delete a creative

DELETE/ads/creatives/{creativeId}

Access: writeZernio: DELETE /v1/ads/creatives/{creativeId}

Try it with MCPAsk your agent to call delete-ad-creative (toolset ads)Set up MCP

Path parameters

creativeIdstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

Returns object

objectstring

ad_creative

idstring
deletedboolean
archivedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/ads/creatives/{creativeId}
curl -X DELETE "https://api.socialit.com/v1/ads/creatives/CREATIVE_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Images

Ad image library

GET/ads/images

Access: readZernio: GET /v1/ads/images

Try it with MCPAsk your agent to call list-ad-images (toolset ads)Set up MCP

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

limitinteger

1–100

afterstring
fieldsstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

ad_image

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null
next_cursorstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/images
curl "https://api.socialit.com/v1/ads/images" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Upload an ad image

POST/ads/images

Access: writeIdempotency-KeyZernio: POST /v1/ads/images

Try it with MCPAsk your agent to call upload-ad-image (toolset ads)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

image_base64string

≤ 41000000 characters

image_urlstring
filenamestring

Returns object

objectstring

ad_image

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/images
curl -X POST "https://api.socialit.com/v1/ads/images" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "image_base64": "string",
    "image_url": "https://example.com"
  }'
Response · 201

Videos

Ad video library

GET/ads/videos

Access: readZernio: GET /v1/ads/videos

Try it with MCPAsk your agent to call list-ad-videos (toolset ads)Set up MCP

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

limitinteger

1–100

afterstring
fieldsstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

ad_video

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null
next_cursorstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/videos
curl "https://api.socialit.com/v1/ads/videos" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Upload an ad video

POST/ads/videos

Access: writeIdempotency-KeyZernio: POST /v1/ads/videos

Try it with MCPAsk your agent to call upload-ad-video (toolset ads)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

video_urlstring
video_base64string

≤ 140000000 characters

filenamestring
titlestring
asyncboolean

Returns object

objectstring

ad_video

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/videos
curl -X POST "https://api.socialit.com/v1/ads/videos" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "video_url": "https://example.com",
    "video_base64": "string"
  }'
Response · 201

Get ad video processing status

GET/ads/videos/{videoId}

Access: readZernio: GET /v1/ads/videos/{videoId}

Try it with MCPAsk your agent to call get-ad-video (toolset ads)Set up MCP

Path parameters

videoIdstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

Returns object

objectstring

ad_video

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/videos/{videoId}
curl "https://api.socialit.com/v1/ads/videos/VIDEO_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Delete an ad video

DELETE/ads/videos/{videoId}

Access: writeZernio: DELETE /v1/ads/videos/{videoId}

Try it with MCPAsk your agent to call delete-ad-video (toolset ads)Set up MCP

Path parameters

videoIdstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

Returns object

objectstring

ad_video

idstring
deletedboolean
archivedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/ads/videos/{videoId}
curl -X DELETE "https://api.socialit.com/v1/ads/videos/VIDEO_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

TikTok identities

List TikTok ad identities

GET/ads/tiktok-identities

Access: readZernio: GET /v1/ads/tiktok-identities

Try it with MCPAsk your agent to call list-tiktok-ad-identities (toolset ads)Set up MCP

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

tiktok_identity

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/tiktok-identities
curl "https://api.socialit.com/v1/ads/tiktok-identities" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Partnership content

List partnership ad content

GET/ads/partnership-content

Access: readZernio: GET /v1/ads/partnership-content

Try it with MCPAsk your agent to call list-ad-partnership-content (toolset ads)Set up MCP

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

creator_usernamestring
post_urlstring
only_allowlistedboolean
instagram_account_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

partnership_content

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/partnership-content
curl "https://api.socialit.com/v1/ads/partnership-content" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Partnership permissions

List partnership permissions

GET/ads/partnership-permissions

Access: readZernio: GET /v1/ads/partnership-permissions

Try it with MCPAsk your agent to call list-ad-partnership-permissions (toolset ads)Set up MCP

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

creator_usernamestring
instagram_account_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

partnership_permission

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/partnership-permissions
curl "https://api.socialit.com/v1/ads/partnership-permissions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Set a partnership permission

POST/ads/partnership-permissions

Access: writeIdempotency-KeyZernio: POST /v1/ads/partnership-permissions

Try it with MCPAsk your agent to call set-ad-partnership-permission (toolset ads)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

creator_usernamestringrequired

1–100 characters

revokeboolean
instagram_account_idstring

Returns object

objectstring

partnership_permission

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/partnership-permissions
curl -X POST "https://api.socialit.com/v1/ads/partnership-permissions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "creator_username": "string",
    "revoke": true
  }'
Response · 200

Insights

Flexible live insights query

GET/ads/insights

Access: readZernio: GET /v1/ads/insights

Try it with MCPAsk your agent to call get-ad-insights (toolset ads)Set up MCP

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

object_idstring
levelstring

accountcampaignad_setad

fieldsstring
breakdownsstring
action_breakdownsstring
action_attribution_windowsstring
action_report_timestring
use_unified_attribution_settingboolean
filteringstring
date_presetstring
from_datestring

pattern ^\d{4}-\d{2}-\d{2}$

to_datestring

pattern ^\d{4}-\d{2}-\d{2}$

time_incrementstring
querystring

≤ 10000 characters

report_typestring
data_levelstring
dimensionsstring
metricsstring
pageinteger

≥ 1

page_sizeinteger

1–1000

page_tokenstring
limitinteger

1–100

afterstring
customer_idstring

Returns object

objectstring

ad_insights

platformstring
ad_account_idstring | null
levelstring | null
dataarray of object
has_moreboolean
next_cursorstring | null
summaryobject | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/insights
curl "https://api.socialit.com/v1/ads/insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Submit an async insights report

POST/ads/insights/reports

Access: writeIdempotency-KeyZernio: POST /v1/ads/insights/reports

Try it with MCPAsk your agent to call create-ad-insights-report (toolset ads)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

object_idstring
levelstring

accountcampaignad_setad

fieldsarray of string
breakdownsarray of string
action_breakdownsarray of string
action_attribution_windowsarray of string
action_report_timestring
use_unified_attribution_settingboolean
filteringarray of object
date_presetstring
from_datestring

pattern ^\d{4}-\d{2}-\d{2}$

to_datestring

pattern ^\d{4}-\d{2}-\d{2}$

time_incrementstring

Returns object

objectstring

ad_insights_report

idstring
statusstring
percent_completenumber | null
dataarray of object
has_moreboolean
next_cursorstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/insights/reports
curl -X POST "https://api.socialit.com/v1/ads/insights/reports" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "object_id": "string",
    "level": "account"
  }'
Response · 201

Poll an async insights report

GET/ads/insights/reports/{reportId}

Access: readZernio: GET /v1/ads/insights/reports/{reportRunId}

Try it with MCPAsk your agent to call get-ad-insights-report (toolset ads)Set up MCP

Path parameters

reportIdstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

limitinteger

1–100

afterstring

Returns object

objectstring

ad_insights_report

idstring
statusstring
percent_completenumber | null
dataarray of object
has_moreboolean
next_cursorstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/insights/reports/{reportId}
curl "https://api.socialit.com/v1/ads/insights/reports/REPORT_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

TikTok smart plus materials

TikTok Smart+ per-creative performance

GET/ads/tiktok-smart-plus-materials

Access: readZernio: GET /v1/ads/tiktok-smart-plus-materials

Try it with MCPAsk your agent to call get-tiktok-smart-plus-materials (toolset ads)Set up MCP

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

start_datestringrequired
end_datestringrequired
levelstring

admaterial

smart_plus_ad_idsstring
ad_group_idsstring
pageinteger

≥ 1

page_sizeinteger

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

smart_plus_material

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null
next_cursorstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/tiktok-smart-plus-materials
curl "https://api.socialit.com/v1/ads/tiktok-smart-plus-materials?start_date=value&end_date=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Search terms

Google Ads search terms report

GET/ads/search-terms

Access: readZernio: GET /v1/ads/search-terms

Try it with MCPAsk your agent to call get-ad-search-terms (toolset ads)Set up MCP

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

from_datestring

pattern ^\d{4}-\d{2}-\d{2}$

to_datestring

pattern ^\d{4}-\d{2}-\d{2}$

campaign_idstring
ad_set_idstring
ad_group_idstring
page_tokenstring
customer_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

search_term

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null
next_cursorstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/search-terms
curl "https://api.socialit.com/v1/ads/search-terms" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Local services

Google Local Services Ads leads

GET/ads/local-services/leads

Access: readZernio: GET /v1/ads/local-services/leads

Try it with MCPAsk your agent to call list-local-services-leads (toolset ads)Set up MCP

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

from_datestring

pattern ^\d{4}-\d{2}-\d{2}$

to_datestring

pattern ^\d{4}-\d{2}-\d{2}$

lead_typestring
lead_statusstring
charged_onlyboolean
page_tokenstring
customer_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

local_services_lead

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null
next_cursorstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/local-services/leads
curl "https://api.socialit.com/v1/ads/local-services/leads" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

List Local Services lead conversations

GET/ads/local-services/leads/{leadId}/conversations

Access: readZernio: GET /v1/ads/local-services/leads/{leadId}/conversations

Try it with MCPAsk your agent to call list-local-services-lead-conversations (toolset ads)Set up MCP

Path parameters

leadIdstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

page_tokenstring
customer_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

local_services_lead_conversation

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null
next_cursorstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/local-services/leads/{leadId}/conversations
curl "https://api.socialit.com/v1/ads/local-services/leads/LEAD_ID/conversations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Keywords

Generate keyword ideas

POST/ads/keywords/ideas

Access: readZernio: POST /v1/ads/keywords/ideas

Try it with MCPAsk your agent to call generate-ad-keyword-ideas (toolset ads)Set up MCP

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

customer_idstring
countriesarray of string
language_idstring
networkstring

GOOGLE_SEARCHGOOGLE_SEARCH_AND_PARTNERS

include_adult_keywordsboolean
seed_keywordsarray of string

≤ 20 items

seed_urlstring
page_sizeinteger

1–10000

page_tokenstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

keyword_idea

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null
next_cursorstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/keywords/ideas
curl -X POST "https://api.socialit.com/v1/ads/keywords/ideas" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "customer_id": "string",
    "countries": [
      "string"
    ]
  }'
Response · 200

Get historical keyword metrics

POST/ads/keywords/historical-metrics

Access: readZernio: POST /v1/ads/keywords/historical-metrics

Try it with MCPAsk your agent to call get-ad-keyword-historical-metrics (toolset ads)Set up MCP

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

customer_idstring
countriesarray of string
language_idstring
networkstring

GOOGLE_SEARCHGOOGLE_SEARCH_AND_PARTNERS

include_adult_keywordsboolean
keywordsarray of stringrequired

1–10000 items

include_average_cpcboolean

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

keyword_idea

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/keywords/historical-metrics
curl -X POST "https://api.socialit.com/v1/ads/keywords/historical-metrics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "customer_id": "string",
    "keywords": [
      "string"
    ]
  }'
Response · 200

List Search keywords

GET/ads/keywords

Access: readZernio: GET /v1/ads/keywords

Try it with MCPAsk your agent to call list-ad-keywords (toolset ads)Set up MCP

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

created_attext

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

profile_idstring
campaign_idstring
ad_set_idstring
statusstring

enabledpausedremoved

match_typestring

exactphrasebroad

negativeboolean
searchstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 19 item attributes
objectstring

ad_keyword

idstring
platformstring
ad_account_idstring | null
campaign_idstring | null
ad_set_idstring | null
external_idstring
criterion_idstring | null
textstring
match_typestring | null
negativeboolean
statusstring
cpc_bidnumber | null
final_urlstring | null
quality_scoreinteger | null
metricsobject | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/keywords
curl "https://api.socialit.com/v1/ads/keywords" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Add Search keywords

POST/ads/keywords

Access: writeIdempotency-KeyZernio: POST /v1/ads/keywords

Try it with MCPAsk your agent to call add-ad-keywords (toolset ads)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

ad_set_idstringrequired
keywordsarray of objectrequired

1–200 items

Show 4 item attributes
textstringrequired

1–80 characters

match_typestring

exactphrasebroad

cpc_bidnumber
final_urlstring
negativeboolean

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 19 item attributes
objectstring

ad_keyword

idstring
platformstring
ad_account_idstring | null
campaign_idstring | null
ad_set_idstring | null
external_idstring
criterion_idstring | null
textstring
match_typestring | null
negativeboolean
statusstring
cpc_bidnumber | null
final_urlstring | null
quality_scoreinteger | null
metricsobject | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/keywords
curl -X POST "https://api.socialit.com/v1/ads/keywords" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "ad_set_id": "string",
    "keywords": [
      {
        "text": "string",
        "match_type": "exact"
      }
    ]
  }'
Response · 201

Pause or enable a Search keyword

PATCH/ads/keywords/{id}

Access: writeZernio: PATCH /v1/ads/keywords/{keywordId}

Try it with MCPAsk your agent to call update-ad-keyword (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Body object

statusstringrequired

enabledpaused

cpc_bidnumber

Returns object

objectstring

ad_keyword

idstring
platformstring
ad_account_idstring | null
campaign_idstring | null
ad_set_idstring | null
external_idstring
criterion_idstring | null
textstring
match_typestring | null
negativeboolean
statusstring
cpc_bidnumber | null
final_urlstring | null
quality_scoreinteger | null
metricsobject | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/keywords/{id}
curl -X PATCH "https://api.socialit.com/v1/ads/keywords/ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "enabled",
    "cpc_bid": 0
  }'
Response · 200

Remove a Search keyword

DELETE/ads/keywords/{id}

Access: writeZernio: DELETE /v1/ads/keywords/{keywordId}

Try it with MCPAsk your agent to call delete-ad-keyword (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Returns object

objectstring

ad_keyword

idstring
deletedboolean
archivedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/ads/keywords/{id}
curl -X DELETE "https://api.socialit.com/v1/ads/keywords/ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Recommendations

List Google Ads recommendations

GET/ads/recommendations

Access: readZernio: GET /v1/ads/recommendations

Try it with MCPAsk your agent to call list-ad-recommendations (toolset ads)Set up MCP

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

campaign_idstring
typesstring
customer_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

ad_recommendation

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/recommendations
curl "https://api.socialit.com/v1/ads/recommendations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Apply Google Ads recommendations

POST/ads/recommendations/apply

Access: writeIdempotency-KeyZernio: POST /v1/ads/recommendations/apply

Try it with MCPAsk your agent to call apply-ad-recommendations (toolset ads)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

recommendationsarray of objectrequired

1–100 items

Show 2 item attributes
idstringrequired
parametersobject
customer_idstring

Returns object

objectstring

ad_recommendation_result

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/recommendations/apply
curl -X POST "https://api.socialit.com/v1/ads/recommendations/apply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "recommendations": [
      {
        "id": "string",
        "parameters": {}
      }
    ],
    "customer_id": "string"
  }'
Response · 200

Dismiss Google Ads recommendations

POST/ads/recommendations/dismiss

Access: writeIdempotency-KeyZernio: POST /v1/ads/recommendations/dismiss

Try it with MCPAsk your agent to call dismiss-ad-recommendations (toolset ads)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

idsarray of string

1–100 items

resource_namesarray of string

≤ 100 items

customer_idstring

Returns object

objectstring

ad_recommendation_result

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/recommendations/dismiss
curl -X POST "https://api.socialit.com/v1/ads/recommendations/dismiss" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "ids": [
      "string"
    ],
    "resource_names": [
      "string"
    ]
  }'
Response · 200

Bid strategies

List portfolio bid strategies

GET/ads/bid-strategies

Access: readZernio: GET /v1/ads/bid-strategies

Try it with MCPAsk your agent to call list-ad-bid-strategies (toolset ads)Set up MCP

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

from_datestring

pattern ^\d{4}-\d{2}-\d{2}$

to_datestring

pattern ^\d{4}-\d{2}-\d{2}$

customer_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

bid_strategy

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/bid-strategies
curl "https://api.socialit.com/v1/ads/bid-strategies" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a portfolio bid strategy

POST/ads/bid-strategies

Access: writeIdempotency-KeyZernio: POST /v1/ads/bid-strategies

Try it with MCPAsk your agent to call create-ad-bid-strategy (toolset ads)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

namestringrequired

1–255 characters

typestringrequired

TARGET_CPATARGET_ROASMAXIMIZE_CONVERSIONSMAXIMIZE_CONVERSION_VALUETARGET_IMPRESSION_SHARETARGET_SPEND

target_cpanumber
target_roasnumber
target_impression_shareobject
customer_idstring

Returns object

objectstring

bid_strategy

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/bid-strategies
curl -X POST "https://api.socialit.com/v1/ads/bid-strategies" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "name": "string",
    "type": "TARGET_CPA"
  }'
Response · 201

Update a portfolio bid strategy

PATCH/ads/bid-strategies/{strategyId}

Access: writeZernio: PATCH /v1/ads/bid-strategies/{strategyId}

Try it with MCPAsk your agent to call update-ad-bid-strategy (toolset ads)Set up MCP

Path parameters

strategyIdstringrequired

1–300 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

namestring
typestring
target_cpanumber
target_roasnumber
target_impression_shareobject
customer_idstring

Returns object

objectstring

bid_strategy

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/bid-strategies/{strategyId}
curl -X PATCH "https://api.socialit.com/v1/ads/bid-strategies/STRATEGY_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "name": "string",
    "type": "string"
  }'
Response · 200

Shared budgets

List shared budgets

GET/ads/shared-budgets

Access: readZernio: GET /v1/ads/shared-budgets

Try it with MCPAsk your agent to call list-ad-shared-budgets (toolset ads)Set up MCP

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

shared_budget

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/shared-budgets
curl "https://api.socialit.com/v1/ads/shared-budgets" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a shared budget

POST/ads/shared-budgets

Access: writeIdempotency-KeyZernio: POST /v1/ads/shared-budgets

Try it with MCPAsk your agent to call create-ad-shared-budget (toolset ads)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

namestringrequired

1–255 characters

amountnumberrequired
typestring

daily

delivery_methodstring

standardaccelerated

Returns object

objectstring

shared_budget

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/shared-budgets
curl -X POST "https://api.socialit.com/v1/ads/shared-budgets" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "name": "string",
    "amount": 1.5
  }'
Response · 201

Interests

Search targeting interests

GET/ads/interests

Access: readZernio: GET /v1/ads/interests

Try it with MCPAsk your agent to call search-ad-interests (toolset ads)Set up MCP

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

qstringrequired

1–200 characters

limitinteger

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

targeting_option

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/interests
curl "https://api.socialit.com/v1/ads/interests?q=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Targeting

Search targeting options

GET/ads/targeting/search

Access: readZernio: GET /v1/ads/targeting/search

Try it with MCPAsk your agent to call search-ad-targeting (toolset ads)Set up MCP

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

qstringrequired

1–200 characters

dimensionstring
geo_typestring
country_codestring
limitinteger

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

targeting_option

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/targeting/search
curl "https://api.socialit.com/v1/ads/targeting/search?q=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Browse targeting categories

GET/ads/targeting/browse

Access: readZernio: GET /v1/ads/targeting/browse

Try it with MCPAsk your agent to call browse-ad-targeting (toolset ads)Set up MCP

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

typestring
parent_idstring
selectableboolean

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

targeting_option

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/targeting/browse
curl "https://api.socialit.com/v1/ads/targeting/browse" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Estimate audience reach

POST/ads/targeting/reach-estimate

Access: readZernio: POST /v1/ads/targeting/reach-estimate

Try it with MCPAsk your agent to call estimate-ad-reach (toolset ads)Set up MCP

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

targetingobject

Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or raw (native spec)

specobject
optimization_goalstring

Returns object

objectstring

reach_estimate

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/targeting/reach-estimate
curl -X POST "https://api.socialit.com/v1/ads/targeting/reach-estimate" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "targeting": {},
    "spec": {}
  }'
Response · 200

Suggested bid and budget bounds

POST/ads/targeting/bid-pricing

Access: readZernio: POST /v1/ads/targeting/bid-pricing

Try it with MCPAsk your agent to call get-ad-bid-pricing (toolset ads)Set up MCP

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

targetingobject

Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or raw (native spec)

specobject
campaign_typestring
bid_typestring

CPMCPCCPV

match_typestring
currencystring
objective_typestring
optimization_target_typestring
daily_budgetnumber

Returns object

objectstring

bid_pricing

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/targeting/bid-pricing
curl -X POST "https://api.socialit.com/v1/ads/targeting/bid-pricing" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "targeting": {},
    "spec": {}
  }'
Response · 200

Forecast ad delivery

POST/ads/targeting/supply-forecast

Access: readZernio: POST /v1/ads/targeting/supply-forecast

Try it with MCPAsk your agent to call get-ad-supply-forecast (toolset ads)Set up MCP

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

targetingobject

Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or raw (native spec)

specobject
campaign_typestring
time_range_startstringrequired
time_range_endstringrequired
objective_typestring
optimization_targetstring
daily_budgetnumber
total_budgetnumber
currencystring
competing_bidnumber
enable_audience_networkboolean
enable_audience_expansionboolean
connected_television_onlyboolean

Returns object

objectstring

supply_forecast

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/targeting/supply-forecast
curl -X POST "https://api.socialit.com/v1/ads/targeting/supply-forecast" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "time_range_start": "string",
    "time_range_end": "string"
  }'
Response · 200

Audiences

List custom audiences

GET/ads/audiences

Access: readZernio: GET /v1/ads/audiences

Try it with MCPAsk your agent to call list-ad-audiences (toolset ads)Set up MCP

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

created_atname

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

profile_idstring
typestring
liveboolean

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 22 item attributes
objectstring

ad_audience

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
descriptionstring | null
typestring
subtypestring | null
statusstring
sizenumber | null
size_lowernumber | null
size_uppernumber | null
specobject
uploaded_countinteger
last_uploaded_atstring (date-time) | null
platform_statusstring | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/audiences
curl "https://api.socialit.com/v1/ads/audiences" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a custom audience

POST/ads/audiences

Access: writeIdempotency-KeyZernio: POST /v1/ads/audiences

Try it with MCPAsk your agent to call create-ad-audience (toolset ads)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

namestringrequired

1–255 characters

descriptionstring

≤ 1000 characters

typestringrequired

customer_listwebsitelookalikeengagementsavedcompany_list

customer_file_sourcestring
retention_daysinteger

1–540

ruleobject
pixel_idstring
source_audience_idstring
countrystring
rationumber

0.01–0.2

engagement_sourceobject
targetingobject

Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or raw (native spec)

specobject
usersarray of object

≤ 10000 items

hashedboolean

Returns object

objectstring

ad_audience

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
descriptionstring | null
typestring
subtypestring | null
statusstring
sizenumber | null
size_lowernumber | null
size_uppernumber | null
specobject
uploaded_countinteger
last_uploaded_atstring (date-time) | null
platform_statusstring | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/audiences
curl -X POST "https://api.socialit.com/v1/ads/audiences" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "name": "string",
    "type": "customer_list"
  }'
Response · 201

Get audience details

GET/ads/audiences/{id}

Access: readZernio: GET /v1/ads/audiences/{audienceId}

Try it with MCPAsk your agent to call get-ad-audience (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Returns object

objectstring

ad_audience

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
descriptionstring | null
typestring
subtypestring | null
statusstring
sizenumber | null
size_lowernumber | null
size_uppernumber | null
specobject
uploaded_countinteger
last_uploaded_atstring (date-time) | null
platform_statusstring | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/audiences/{id}
curl "https://api.socialit.com/v1/ads/audiences/ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Update an audience

PATCH/ads/audiences/{id}

Access: writeZernio: PUT /v1/ads/audiences/{audienceId}

Try it with MCPAsk your agent to call update-ad-audience (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Body object

namestring

1–255 characters

descriptionstring | null

≤ 1000 characters

specobject

Returns object

objectstring

ad_audience

idstring
platformstring
ad_account_idstring | null
connection_idstring | null
profile_idstring | null
external_idstring
namestring | null
descriptionstring | null
typestring
subtypestring | null
statusstring
sizenumber | null
size_lowernumber | null
size_uppernumber | null
specobject
uploaded_countinteger
last_uploaded_atstring (date-time) | null
platform_statusstring | null
synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/audiences/{id}
curl -X PATCH "https://api.socialit.com/v1/ads/audiences/ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "spec": {}
  }'
Response · 200

Delete a custom audience

DELETE/ads/audiences/{id}

Access: writeZernio: DELETE /v1/ads/audiences/{audienceId}

Try it with MCPAsk your agent to call delete-ad-audience (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Returns object

objectstring

ad_audience

idstring
deletedboolean
archivedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/ads/audiences/{id}
curl -X DELETE "https://api.socialit.com/v1/ads/audiences/ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Add users to an audience

POST/ads/audiences/{id}/users

Access: writeIdempotency-KeyZernio: POST /v1/ads/audiences/{audienceId}/users

Try it with MCPAsk your agent to call add-ad-audience-users (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

usersarray of objectrequired

1–10000 items

Show 10 item attributes
emailstring
phonestring
first_namestring
last_namestring
countrystring
zipstring
citystring
statestring
external_idstring
mobile_advertiser_idstring
operationstring

addremove

hashedboolean

Returns object

objectstring

ad_audience_upload

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/audiences/{id}/users
curl -X POST "https://api.socialit.com/v1/ads/audiences/ID/users" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "users": [
      {
        "email": "you@example.com",
        "phone": "+15551234567"
      }
    ],
    "operation": "add",
    "hashed": true
  }'
Response · 200

Replace audience companies

POST/ads/audiences/{id}/companies

Access: writeIdempotency-KeyZernio: POST /v1/ads/audiences/{audienceId}/companies

Try it with MCPAsk your agent to call replace-ad-audience-companies (toolset ads)Set up MCP

Path parameters

idstringrequired

1–300 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

companiesarray of objectrequired

1–300000 items

Show 5 item attributes
company_namestring
company_websitestring
company_email_domainstring
linkedin_company_page_urlstring
organization_urnstring

Returns object

objectstring

ad_audience_upload

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/audiences/{id}/companies
curl -X POST "https://api.socialit.com/v1/ads/audiences/ID/companies" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "companies": [
      {
        "company_name": "string",
        "company_website": "https://example.com"
      }
    ]
  }'
Response · 200

Library

Search the public Ad Library

GET/ads/library

Access: readZernio: GET /v1/ads/library

Try it with MCPAsk your agent to call search-ad-library (toolset ads)Set up MCP

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

platformstring

Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)

1–40 characters

qstring
page_idsstring
advertiserstring
countriesstring
ad_typestring
statusstring
platformsstring
media_typestring
languagesstring
sincestring
untilstring
search_typestring
fieldsstring
limitinteger

1–100

afterstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 1 item attributes
objectstring

ad_library_ad

pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null
next_cursorstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/library
curl "https://api.socialit.com/v1/ads/library" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Rf predictions

Create a reach & frequency prediction

POST/ads/rf-predictions

Access: writeIdempotency-KeyZernio: POST /v1/ads/rf-predictions

Try it with MCPAsk your agent to call create-ad-reach-frequency-prediction (toolset ads)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

budget_amountnumber
reachinteger

≥ 1

start_timestringrequired
end_timestringrequired
frequency_capobject
targetingobject

Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or raw (native spec)

placementsobject
objectivestring
prediction_modeinteger

Returns object

objectstring

rf_prediction

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/rf-predictions
curl -X POST "https://api.socialit.com/v1/ads/rf-predictions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string",
    "start_time": "string",
    "end_time": "string"
  }'
Response · 201

Get a reach & frequency prediction

GET/ads/rf-predictions/{predictionId}

Access: readZernio: GET /v1/ads/rf-predictions/{predictionId}

Try it with MCPAsk your agent to call get-ad-reach-frequency-prediction (toolset ads)Set up MCP

Path parameters

predictionIdstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

Returns object

objectstring

rf_prediction

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/rf-predictions/{predictionId}
curl "https://api.socialit.com/v1/ads/rf-predictions/PREDICTION_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Cancel a reach & frequency booking

DELETE/ads/rf-predictions/{predictionId}

Access: writeZernio: DELETE /v1/ads/rf-predictions/{predictionId}

Try it with MCPAsk your agent to call cancel-ad-reach-frequency-prediction (toolset ads)Set up MCP

Path parameters

predictionIdstringrequired

1–300 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

Returns object

objectstring

rf_prediction

idstring
deletedboolean
archivedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/ads/rf-predictions/{predictionId}
curl -X DELETE "https://api.socialit.com/v1/ads/rf-predictions/PREDICTION_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Reserve reach & frequency inventory

POST/ads/rf-predictions/{predictionId}/reserve

Access: writeIdempotency-KeyZernio: POST /v1/ads/rf-predictions/{predictionId}/reserve

Try it with MCPAsk your agent to call reserve-ad-reach-frequency-prediction (toolset ads)Set up MCP

Path parameters

predictionIdstringrequired

1–300 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_123, Google customer id, TikTok advertiser id…)

≤ 120 characters

Returns object

objectstring

rf_prediction

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/rf-predictions/{predictionId}/reserve
curl -X POST "https://api.socialit.com/v1/ads/rf-predictions/PREDICTION_ID/reserve" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_account_id": "ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "connection_id": "adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platform_ad_account_id": "string"
  }'
Response · 200