Skip to content
Docs

Ads: accounts & measurement

Ad accounts, account-level ad management, tracking tags, lead gen, product catalogs and conversions.

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits135 endpointsMCP toolset ads_measurement

Connections

Update an ads connection

PATCH/ads/connections/{connectionId}

Changes the local label of an ads connection or moves it (and its ad accounts) to another profile.

Access: write

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

Path parameters

connectionIdstringrequired

Ads connection id (adc_…)

1–80 characters

Body object

namestring | null

≤ 100 characters

profile_idstring | null

≤ 80 characters

Returns object

objectstringrequired

ad_connection

idstring
platformstring
connect_flowstring | null
profile_idstring | null
social_account_idstring | null
external_user_idstring
namestring | null
display_namestring | null
avatar_urlstring | null
statusstring

activeneeds_reconnectdisconnected

scopesarray of string
token_expires_atstring (date-time) | null
metadataobject
ad_account_countinteger
syncobject
Show 4 child attributes
statusstring
errorstring | null
last_synced_atstring (date-time) | null
initial_sync_completed_atstring (date-time) | null
last_discovered_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/connections/{connectionId}
curl -X PATCH "https://api.socialit.com/v1/ads/connections/adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "profile_id": "string"
  }'
Response · 200

Re-discover ad accounts

POST/ads/connections/{connectionId}/discover

Lists the ad accounts the connection reaches on the network now: new ones are added (selected), vanished ones become closed.

Access: write

Try it with MCPAsk your agent to call discover-ad-connection-accounts (toolset ads_measurement)Set up MCP

Path parameters

connectionIdstringrequired

Ads connection id (adc_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 25 item attributes
objectstringrequired

ad_account

idstring
connection_idstring | null
profile_idstring | null
platformstring
external_idstring
namestring | null
currencystring | null
timezonestring | null
statusstring
platform_statusstring | null
business_idstring | null
business_namestring | null
manager_customer_idstring | null
is_managerboolean
is_testboolean
selectedboolean
selectableboolean
unusable_reasonstring | null
billing_statusstring
metadataobject
last_discovered_atstring (date-time) | null
last_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
POST/ads/connections/{connectionId}/discover
curl -X POST "https://api.socialit.com/v1/ads/connections/adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discover" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

List business portfolios

GET/ads/connections/{connectionId}/businesses

Meta business portfolios the connected user belongs to, with their verification status.

Access: readZernio: GET /v1/ads/businesses

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

Path parameters

connectionIdstringrequired

Ads connection id (adc_…)

1–80 characters

Query parameters

limitintegerdefault: 25

Items per page (max 100)

1–100

cursorstring

next_cursor from the previous page

≤ 4096 characters

afterstring

Alias of cursor

≤ 4096 characters

Returns object

objectstring

list

dataarray of object
Show 6 item attributes
objectstringrequired

business

idstring
namestring | null
verification_statusstring | null
created_atstring (date-time) | null
permitted_tasksarray of string
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/connections/{connectionId}/businesses
curl "https://api.socialit.com/v1/ads/connections/adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/businesses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

List business users

GET/ads/connections/{connectionId}/businesses/{businessId}/users

People and system users of a Meta business portfolio (the ids to assign to Pages, ad accounts and pixels).

Access: readZernio: GET /v1/ads/businesses/users

Try it with MCPAsk your agent to call list-ad-business-users (toolset ads_measurement)Set up MCP

Path parameters

connectionIdstringrequired

Ads connection id (adc_…)

1–80 characters

businessIdstringrequired

1–256 characters

Returns object

objectstring

list

dataarray of object
Show 6 item attributes
objectstringrequired

business_user

idstring
namestring | null
emailstring | null
rolestring | null
typestring
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/connections/{connectionId}/businesses/{businessId}/users
curl "https://api.socialit.com/v1/ads/connections/adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/businesses/BUSINESS_ID/users" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

List TikTok Business Centers

GET/ads/connections/{connectionId}/business-centers

The TikTok Business Centers the connection can read, with their advertiser counts.

Access: readZernio: GET /v1/ads/business-centers

Try it with MCPAsk your agent to call list-ad-business-centers (toolset ads_measurement)Set up MCP

Path parameters

connectionIdstringrequired

Ads connection id (adc_…)

1–80 characters

Returns object

objectstring

list

dataarray of object
Show 5 item attributes
objectstringrequired

business_center

idstring
namestring | null
advertiser_countinteger | null
rolestring | null
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/connections/{connectionId}/business-centers
curl "https://api.socialit.com/v1/ads/connections/adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/business-centers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

List Page users

GET/ads/connections/{connectionId}/pages/{pageId}/users

People of a business portfolio assigned to a Facebook Page.

Access: readZernio: GET /v1/ads/page-users

Try it with MCPAsk your agent to call list-ad-page-users (toolset ads_measurement)Set up MCP

Path parameters

connectionIdstringrequired

Ads connection id (adc_…)

1–80 characters

pageIdstringrequired

1–256 characters

Query parameters

business_idstringrequired

1–64 characters

Returns object

objectstring

list

dataarray of object
Show 5 item attributes
objectstringrequired

page_user

idstring
page_idstring
namestring | null
tasksarray of string
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/connections/{connectionId}/pages/{pageId}/users
curl "https://api.socialit.com/v1/ads/connections/adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pages/PAGE_ID/users?business_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Assign a user to a Page

POST/ads/connections/{connectionId}/pages/{pageId}/users

Gives a business user tasks on a Facebook Page (replaces their task set). ADVERTISE is what ad creation needs.

Access: adminIdempotency-KeyZernio: POST /v1/ads/page-users

Try it with MCPAsk your agent to call assign-ad-page-user (toolset ads_measurement)Set up MCP

Path parameters

connectionIdstringrequired

Ads connection id (adc_…)

1–80 characters

pageIdstringrequired

1–256 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

business_idstringrequired

1–64 characters

user_idstringrequired

1–64 characters

tasksarray of stringrequired

≥ 1 items

Returns object

objectstringrequired

page_user

idstring
page_idstring
namestring | null
tasksarray of string

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/connections/{connectionId}/pages/{pageId}/users
curl -X POST "https://api.socialit.com/v1/ads/connections/adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pages/PAGE_ID/users" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "business_id": "string",
    "user_id": "string",
    "tasks": [
      "MANAGE"
    ]
  }'
Response · 201

Remove a user from a Page

DELETE/ads/connections/{connectionId}/pages/{pageId}/users/{userId}

Access: adminZernio: DELETE /v1/ads/page-users

Try it with MCPAsk your agent to call remove-ad-page-user (toolset ads_measurement)Set up MCP

Path parameters

connectionIdstringrequired

Ads connection id (adc_…)

1–80 characters

pageIdstringrequired

1–256 characters

userIdstringrequired

1–256 characters

Query parameters

business_idstring

1–64 characters

Returns object

objectstringrequired

page_user

idstringrequired
deletedbooleanrequired

Responses

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

Get the Google Ads manager hierarchy

GET/ads/connections/{connectionId}/hierarchy

Live manager (MCC) and client tree of a Google Ads connection, with pending invitations and link status.

Access: readZernio: GET /v1/ads/accounts/hierarchy

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

Path parameters

connectionIdstringrequired

Ads connection id (adc_…)

1–80 characters

Returns object

objectstringrequired

manager_hierarchy

connection_idstring
rootsarray of object
Show 9 item attributes
customer_idstring
namestring | null
currencystring | null
time_zonestring | null
managerboolean
test_accountboolean
statusstring | null
manager_linksarray of object
Show 3 item attributes
manager_customer_idstring | null
manager_link_idstring | null
statusstring
clientsarray of object
Show 12 item attributes
customer_idstring
namestring | null
currencystring | null
time_zonestring | null
managerboolean
test_accountboolean
hiddenboolean
levelinteger
statusstring | null
parent_customer_idstring | null
manager_link_idstring | null
link_statusstring | null
direct_customersarray of object
Show 3 item attributes
customer_idstring
managerboolean
pending_invitationsarray of object
Show 2 item attributes
manager_customer_idstring | null
manager_link_idstring | null
unavailablearray of object
Show 2 item attributes
customer_idstring
reasonstring
truncatedboolean

Responses

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

Sends a manager-to-client link invitation (Google Ads). The link stays PENDING until the client accepts.

Access: adminIdempotency-KeyZernio: POST /v1/ads/accounts/manager-links

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

Path parameters

connectionIdstringrequired

Ads connection id (adc_…)

1–80 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

manager_customer_idstringrequired

1–20 characters

client_customer_idstringrequired

1–20 characters

validate_onlyboolean

Returns object

objectstringrequired

manager_link

manager_customer_idstring
client_customer_idstring
manager_link_idstring | null
statusstring
validate_onlyboolean

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/connections/{connectionId}/manager-links
curl -X POST "https://api.socialit.com/v1/ads/connections/adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/manager-links" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "manager_customer_id": "string",
    "client_customer_id": "string",
    "validate_only": true
  }'
Response · 201
PATCH/ads/connections/{connectionId}/manager-links/{managerLinkId}

Access: adminZernio: PATCH /v1/ads/accounts/manager-links

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

Path parameters

connectionIdstringrequired

Ads connection id (adc_…)

1–80 characters

managerLinkIdstringrequired

1–256 characters

Body object

manager_customer_idstringrequired

1–20 characters

client_customer_idstringrequired

1–20 characters

actionstringrequired

acceptdeclinecancelunlink

validate_onlyboolean

Returns object

objectstringrequired

manager_link

manager_customer_idstring
client_customer_idstring
manager_link_idstring | null
statusstring
validate_onlyboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/connections/{connectionId}/manager-links/{managerLinkId}
curl -X PATCH "https://api.socialit.com/v1/ads/connections/adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/manager-links/MANAGER_LINK_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "manager_customer_id": "string",
    "client_customer_id": "string",
    "action": "accept",
    "validate_only": true
  }'
Response · 200

Accounts

List ad accounts

GET/ads/accounts

The platform ad accounts reached by the workspace ads connections. refresh=true re-discovers the matching connections live first.

Access: readZernio: GET /v1/ads/accounts

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

Query parameters

pageintegerdefault: 1

≥ 1

limitintegerdefault: 20

1–100

connection_idstring

1–80 characters

platformstring

1–40 characters

profile_idstring

1–80 characters

statusstring

activependingdisabledclosedunknown

selectedboolean
external_idstring

1–256 characters

searchstring

1–200 characters

refreshboolean
in_scope_onlyboolean
sortstring

namecreated_atplatformstatus

orderstring

ascdesc

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 25 item attributes
objectstringrequired

ad_account

idstring
connection_idstring | null
profile_idstring | null
platformstring
external_idstring
namestring | null
currencystring | null
timezonestring | null
statusstring
platform_statusstring | null
business_idstring | null
business_namestring | null
manager_customer_idstring | null
is_managerboolean
is_testboolean
selectedboolean
selectableboolean
unusable_reasonstring | null
billing_statusstring
metadataobject
last_discovered_atstring (date-time) | null
last_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/accounts
curl "https://api.socialit.com/v1/ads/accounts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a Meta ad account

POST/ads/accounts

Creates an ad account in a Meta business portfolio (a payment method must then be added in Ads Manager).

Access: adminIdempotency-KeyZernio: POST /v1/ads/accounts

Try it with MCPAsk your agent to call create-ad-account (toolset ads_measurement)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

connection_idstringrequired

1–80 characters

business_idstringrequired

1–64 characters

namestringrequired

1–100 characters

currencystringrequired

pattern ^[A-Za-z]{3}$

timezone_idintegerrequired
end_advertiserstring

1–64 characters

media_agencystring

1–64 characters

partnerstring

1–64 characters

invoiceboolean
invoice_group_idstring

1–64 characters

invoicing_emailsarray of string (email)

≤ 20 items

ioboolean
po_numberstring

1–64 characters

funding_idstring

1–64 characters

Returns object

objectstringrequired

ad_account

idstring
connection_idstring | null
profile_idstring | null
platformstring
external_idstring
namestring | null
currencystring | null
timezonestring | null
statusstring
platform_statusstring | null
business_idstring | null
business_namestring | null
manager_customer_idstring | null
is_managerboolean
is_testboolean
selectedboolean
selectableboolean
unusable_reasonstring | null
billing_statusstring
metadataobject
last_discovered_atstring (date-time) | null
last_synced_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
payment_method_requiredboolean
ads_manager_urlstring | null
next_stepsstring | null
warningsarray of string

Responses

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

Get an ad account

GET/ads/accounts/{adAccountId}

Access: read

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

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Returns object

objectstringrequired

ad_account

idstring
connection_idstring | null
profile_idstring | null
platformstring
external_idstring
namestring | null
currencystring | null
timezonestring | null
statusstring
platform_statusstring | null
business_idstring | null
business_namestring | null
manager_customer_idstring | null
is_managerboolean
is_testboolean
selectedboolean
selectableboolean
unusable_reasonstring | null
billing_statusstring
metadataobject
last_discovered_atstring (date-time) | null
last_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/accounts/{adAccountId}
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Select or move an ad account

PATCH/ads/accounts/{adAccountId}

Local settings: selected (managed, synced, billed) and profile_id.

Access: write

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

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Body object

selectedboolean
profile_idstring | null

≤ 80 characters

Returns object

objectstringrequired

ad_account

idstring
connection_idstring | null
profile_idstring | null
platformstring
external_idstring
namestring | null
currencystring | null
timezonestring | null
statusstring
platform_statusstring | null
business_idstring | null
business_namestring | null
manager_customer_idstring | null
is_managerboolean
is_testboolean
selectedboolean
selectableboolean
unusable_reasonstring | null
billing_statusstring
metadataobject
last_discovered_atstring (date-time) | null
last_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/accounts/{adAccountId}
curl -X PATCH "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "selected": true,
    "profile_id": "string"
  }'
Response · 200

Update ad account settings on the network

PATCH/ads/accounts/{adAccountId}/settings

Meta: name, spend cap, amount-spent reset, default DSA beneficiary / payor. Google: account tracking template and final URL suffix.

Access: writeZernio: PATCH /v1/ads/accounts

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

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Body object

namestring

1–100 characters

spend_capnumber | null
reset_amount_spentboolean
default_dsa_beneficiarystring

1–512 characters

default_dsa_payorstring

1–512 characters

tracking_url_templatestring

≤ 2048 characters

final_url_suffixstring

≤ 2048 characters

Returns object

objectstringrequired

ad_account_settings

ad_account_idstring
platformstring
namestring | null
spend_capnumber | null
url_trackingobject | null
Show 2 child attributes
tracking_url_templatestring | null
final_url_suffixstring | null
dsa_defaultsobject | null
Show 2 child attributes
beneficiarystring | null
payorstring | null
financeobject | null
Show 7 child attributes
objectstring

ad_account_finance

ad_account_idstring
currencystring | null
balancenumber | null
amount_spentnumber | null
spend_capnumber | null
funding_sourceobject | null
Show 2 child attributes
display_stringstring | null
typenumber | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/accounts/{adAccountId}/settings
curl -X PATCH "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/settings" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "spend_cap": 0,
    "reset_amount_spent": true,
    "default_dsa_beneficiary": "string",
    "default_dsa_payor": "string"
  }'
Response · 200

Get ad account finances

GET/ads/accounts/{adAccountId}/finance

Balance, total spend, spend cap and funding source (Meta).

Access: readZernio: GET /v1/ads/accounts/finance

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

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Returns object

objectstringrequired

ad_account_finance

ad_account_idstring
currencystring | null
balancenumber | null
amount_spentnumber | null
spend_capnumber | null
funding_sourceobject | null
Show 2 child attributes
display_stringstring | null
typenumber | null

Responses

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

Read campaigns and ad sets live

GET/ads/accounts/{adAccountId}/live

Reads campaigns and ad sets straight from the network (Meta, TikTok), e.g. to check budgets before a write.

Access: readZernio: GET /v1/ads/accounts/live

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

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Query parameters

statusstring

1–200 characters

levelstring

campaignad_set

limitintegerdefault: 100

1–200

campaigns_cursorstring

1–4096 characters

ad_sets_cursorstring

1–4096 characters

Returns object

objectstringrequired

ad_account_live

ad_account_idstring
platformstring
currencystring | null
read_atstring (date-time) | null
campaignsarray of object
Show 11 item attributes
idstring
namestring | null
statusstring
platform_statusstring | null
configured_statusstring | null
budgetobject | null
Show 2 child attributes
amountnumber
typestring
daily_budgetnumber | null
lifetime_budgetnumber | null
budget_remainingnumber | null
bid_strategystring | null
spend_capnumber | null
ad_setsarray of object
Show 18 item attributes
idstring
namestring | null
statusstring
platform_statusstring | null
configured_statusstring | null
budgetobject | null
Show 2 child attributes
amountnumber
typestring
daily_budgetnumber | null
lifetime_budgetnumber | null
budget_remainingnumber | null
bid_strategystring | null
campaign_idstring | null
bid_amountnumber | null
optimization_goalstring | null
billing_eventstring | null
promoted_objectobject | null
targetingobject | null
start_timestring (date-time) | null
end_timestring (date-time) | null
next_cursorsobject
Show 2 child attributes
campaignsstring | null
ad_setsstring | null

Responses

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

Get DSA defaults

GET/ads/accounts/{adAccountId}/dsa-defaults

Access: readZernio: GET /v1/ads/dsa-defaults

Try it with MCPAsk your agent to call get-ad-account-dsa-defaults (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Returns object

objectstringrequired

dsa_defaults

ad_account_idstring
beneficiarystring | null
payorstring | null

Responses

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

Get DSA recommendations

GET/ads/accounts/{adAccountId}/dsa-recommendations

Suggested beneficiary / payor names for EU DSA disclosures (never applied automatically).

Access: readZernio: GET /v1/ads/dsa-recommendations

Try it with MCPAsk your agent to call get-ad-account-dsa-recommendations (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Returns object

objectstringrequired

dsa_recommendations

ad_account_idstring
recommendationsarray of string

Responses

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

List ad account users

GET/ads/accounts/{adAccountId}/users

Access: readZernio: GET /v1/ads/accounts/users

Try it with MCPAsk your agent to call list-ad-account-users (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Query parameters

business_idstring

1–64 characters

Returns object

objectstring

list

dataarray of object
Show 6 item attributes
objectstringrequired

ad_account_user

idstring
namestring | null
emailstring | null
rolestring | null
tasksarray of string
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/users
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/users" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Assign a user to an ad account

POST/ads/accounts/{adAccountId}/users

MANAGE = admin, ADVERTISE creates ads, ANALYZE reads reports, DRAFT edits drafts. Replaces the user’s task set.

Access: adminIdempotency-KeyZernio: POST /v1/ads/accounts/users

Try it with MCPAsk your agent to call assign-ad-account-user (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 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

user_idstringrequired

1–64 characters

tasksarray of stringrequired

≥ 1 items

business_idstring

1–64 characters

Returns object

objectstringrequired

ad_account_user

idstring
namestring | null
emailstring | null
rolestring | null
tasksarray of string

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/accounts/{adAccountId}/users
curl -X POST "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/users" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "string",
    "tasks": [
      "MANAGE"
    ],
    "business_id": "string"
  }'
Response · 201

Remove a user from an ad account

DELETE/ads/accounts/{adAccountId}/users/{userId}

Access: adminZernio: DELETE /v1/ads/accounts/users

Try it with MCPAsk your agent to call remove-ad-account-user (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

userIdstringrequired

1–256 characters

Returns object

objectstringrequired

ad_account_user

idstringrequired
deletedbooleanrequired

Responses

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

Ad account change log

GET/ads/accounts/{adAccountId}/activity

Who changed what and when (Meta activities, Google change history: last 30 days).

Access: readZernio: GET /v1/ads/activity

Try it with MCPAsk your agent to call list-ad-account-activity (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Query parameters

sincestring

YYYY-MM-DD

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

untilstring

YYYY-MM-DD

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

object_idstring

1–64 characters

limitintegerdefault: 25

Items per page (max 100)

1–100

cursorstring

next_cursor from the previous page

≤ 4096 characters

afterstring

Alias of cursor

≤ 4096 characters

Returns object

objectstring

list

dataarray of object
Show 12 item attributes
objectstringrequired

ad_activity

idstring | null
event_typestring | null
event_timestring (date-time) | null
actor_idstring | null
actor_namestring | null
object_typestring | null
object_idstring | null
object_namestring | null
application_namestring | null
translated_event_typestring | null
extra_dataobject | null
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/activity
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/activity" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

List A/B tests and lift studies

GET/ads/accounts/{adAccountId}/studies

Access: readZernio: GET /v1/ads/studies

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

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Query parameters

fieldsstring

1–2000 characters

limitintegerdefault: 25

Items per page (max 100)

1–100

cursorstring

next_cursor from the previous page

≤ 4096 characters

afterstring

Alias of cursor

≤ 4096 characters

Returns object

objectstring

list

dataarray of object
Show 9 item attributes
objectstringrequired

ad_study

idstring
namestring | null
typestring | null
descriptionstring | null
start_timestring (date-time) | null
end_timestring (date-time) | null
cellsarray of object
rawobject
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/studies
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/studies" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

List Instagram ad identities

GET/ads/accounts/{adAccountId}/instagram-accounts

Access: readZernio: GET /v1/ads/instagram-accounts

Try it with MCPAsk your agent to call list-ad-instagram-accounts (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Returns object

objectstringrequired

instagram_identities

ad_account_idstring
accountsarray of object
Show 5 item attributes
ig_user_idstring
usernamestring | null
profile_picture_urlstring | null
is_page_backedboolean
sourcestring
pagesarray of object
Show 4 item attributes
page_idstring
namestring | null
instagram_business_accountobject | null
Show 3 child attributes
ig_user_idstring
usernamestring | null
profile_picture_urlstring | null
connected_instagram_accountobject | null
Show 3 child attributes
ig_user_idstring
usernamestring | null
profile_picture_urlstring | null
resolvedobject
Show 3 child attributes
page_idstring | null
ig_user_idstring | null
sourcestring | null

Responses

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

List Instagram posts to boost

GET/ads/accounts/{adAccountId}/instagram-posts

Access: readZernio: GET /v1/ads/instagram-posts

Try it with MCPAsk your agent to call list-ad-instagram-posts (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Query parameters

ig_user_idstring

1–64 characters

limitintegerdefault: 25

Items per page (max 100)

1–100

cursorstring

next_cursor from the previous page

≤ 4096 characters

afterstring

Alias of cursor

≤ 4096 characters

Returns object

objectstring

list

dataarray of object
Show 8 item attributes
objectstringrequired

instagram_post

idstring
captionstring | null
media_typestring
media_urlstring | null
thumbnail_urlstring | null
permalinkstring | null
timestampstring (date-time) | null
pageinteger
limitinteger
totalinteger | null
has_moreboolean
next_page_urlstring | null
previous_page_urlstring | null
next_cursorstring | null
ig_user_idstring | null
usernamestring | null

Responses

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

List advertisable apps

GET/ads/accounts/{adAccountId}/advertisable-applications

Access: readZernio: GET /v1/ads/advertisable-applications

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

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Returns object

objectstring

list

dataarray of object
Show 5 item attributes
objectstringrequired

advertisable_application

idstring
namestring | null
supported_platformsarray of string
store_urlsobject
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/advertisable-applications
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/advertisable-applications" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Get iOS 14 campaign limits

GET/ads/accounts/{adAccountId}/ios-campaign-limits

Access: readZernio: GET /v1/ads/ios-fourteen-campaign-limits

Try it with MCPAsk your agent to call get-ios-campaign-limits (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Query parameters

application_idstringrequired

1–64 characters

Returns object

objectstringrequired

ios_campaign_limits

application_idstring
campaign_group_limitnumber | null
campaign_limitnumber | null
detailsarray of object

Responses

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

List TikTok pixels

GET/ads/accounts/{adAccountId}/pixels

TikTok pixels with their supported optimization events.

Access: readZernio: GET /v1/ads/pixels

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

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Query parameters

codestring

1–64 characters

Returns object

objectstring

list

dataarray of object
Show 6 item attributes
objectstringrequired

ad_pixel

idstring
codestring | null
namestring | null
eventsarray of string
event_detailsarray of object
Show 3 item attributes
namestring | null
optimization_eventstring | null
customboolean
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/pixels
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pixels" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

List custom conversions

GET/ads/accounts/{adAccountId}/custom-conversions

Meta custom conversions of the ad account, archived included.

Access: readZernio: GET /v1/accounts/{accountId}/custom-conversions

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

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Returns object

objectstring

list

dataarray of object
Show 9 item attributes
objectstringrequired

custom_conversion

idstring
namestring | null
ruleobject | null
custom_event_typestring | null
pixel_idstring | null
is_archivedboolean
default_conversion_valuenumber | null
reusedboolean
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/custom-conversions
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/custom-conversions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a custom conversion

POST/ads/accounts/{adAccountId}/custom-conversions

Creates a Meta custom conversion, or returns the existing non-archived one with the same name on the same pixel (reused: true, 200).

Access: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/custom-conversions

Try it with MCPAsk your agent to call create-custom-conversion (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 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

namestringrequired

1–100 characters

pixel_idstringrequired

1–64 characters

custom_event_typestringrequired

1–64 characters

ruleobjectrequired
default_conversion_valuenumber

Returns object

objectstringrequired

custom_conversion

idstring
namestring | null
ruleobject | null
custom_event_typestring | null
pixel_idstring | null
is_archivedboolean
default_conversion_valuenumber | null
reusedboolean

Responses

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

List ad labels

GET/ads/accounts/{adAccountId}/labels

Access: readZernio: GET /v1/ads/labels

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

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Query parameters

limitintegerdefault: 25

Items per page (max 100)

1–100

cursorstring

next_cursor from the previous page

≤ 4096 characters

afterstring

Alias of cursor

≤ 4096 characters

Returns object

objectstring

list

dataarray of object
Show 9 item attributes
objectstringrequired

ad_label

idstring
namestring | null
statusstring | null
background_colorstring | null
descriptionstring | null
resource_namestring | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/labels
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/labels" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create an ad label

POST/ads/accounts/{adAccountId}/labels

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

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

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 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

namestringrequired

1–80 characters

background_colorstring

pattern ^#[0-9A-Fa-f]{6}$

descriptionstring

1–200 characters

Returns object

objectstringrequired

ad_label

idstring
namestring | null
statusstring | null
background_colorstring | null
descriptionstring | null
resource_namestring | 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/accounts/{adAccountId}/labels
curl -X POST "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/labels" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "background_color": "string",
    "description": "string"
  }'
Response · 201

Update an ad label

PATCH/ads/accounts/{adAccountId}/labels/{labelId}

Access: writeZernio: PATCH /v1/ads/labels/{labelId}

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

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

labelIdstringrequired

1–256 characters

Body object

namestring

1–80 characters

background_colorstring

pattern ^#[0-9A-Fa-f]{6}$

descriptionstring

1–200 characters

Returns object

objectstringrequired

ad_label

idstring
namestring | null
statusstring | null
background_colorstring | null
descriptionstring | null
resource_namestring | 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/accounts/{adAccountId}/labels/{labelId}
curl -X PATCH "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/labels/LABEL_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "background_color": "string",
    "description": "string"
  }'
Response · 200

Remove an ad label

DELETE/ads/accounts/{adAccountId}/labels/{labelId}

Access: writeZernio: DELETE /v1/ads/labels/{labelId}

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

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

labelIdstringrequired

1–256 characters

Returns object

objectstringrequired

ad_label

idstringrequired
deletedbooleanrequired

Responses

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

Attach a label

POST/ads/accounts/{adAccountId}/labels/{labelId}/assignments

Attaches a Google Ads label to campaigns, ad groups, ads and keywords; targets that already carry it count as unchanged.

Access: writeIdempotency-KeyZernio: POST /v1/ads/labels/{labelId}/assignments

Try it with MCPAsk your agent to call attach-ad-label (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

labelIdstringrequired

1–256 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

campaign_idsarray of string

≤ 1000 items

ad_set_idsarray of string

≤ 1000 items

ad_idsarray of string

≤ 1000 items

keyword_idsarray of string

≤ 1000 items

Returns object

objectstringrequired

label_assignment_result

label_idstring
attachedinteger
detachedinteger
unchangedinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/accounts/{adAccountId}/labels/{labelId}/assignments
curl -X POST "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/labels/LABEL_ID/assignments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "campaign_ids": [
      "string"
    ],
    "ad_set_ids": [
      "string"
    ],
    "ad_ids": [
      "string"
    ],
    "keyword_ids": [
      "string"
    ]
  }'
Response · 200

Detach a label

DELETE/ads/accounts/{adAccountId}/labels/{labelId}/assignments

Access: writeZernio: DELETE /v1/ads/labels/{labelId}/assignments

Try it with MCPAsk your agent to call detach-ad-label (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

labelIdstringrequired

1–256 characters

Query parameters

campaign_idsstring

Comma separated ids

≤ 10000 characters

ad_set_idsstring

Comma separated ids

≤ 10000 characters

ad_idsstring

Comma separated ids

≤ 10000 characters

keyword_idsstring

Comma separated ids

≤ 10000 characters

Returns object

objectstringrequired

label_assignment_result

label_idstring
attachedinteger
detachedinteger
unchangedinteger

Responses

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

List high-demand periods

GET/ads/accounts/{adAccountId}/high-demand-periods

Scheduled budget increases on a Meta campaign or ad set (exactly one of campaign_id / ad_set_id).

Access: readZernio: GET /v1/ads/high-demand-periods

Try it with MCPAsk your agent to call list-high-demand-periods (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Query parameters

campaign_idstring

1–64 characters

ad_set_idstring

1–64 characters

limitintegerdefault: 25

Items per page (max 100)

1–100

cursorstring

next_cursor from the previous page

≤ 4096 characters

afterstring

Alias of cursor

≤ 4096 characters

Returns object

objectstring

list

dataarray of object
Show 9 item attributes
objectstringrequired

high_demand_period

idstring
target_idstring
budget_valuenumber | null
budget_value_typestring | null
time_startstring (date-time) | null
time_endstring (date-time) | null
recurrence_typestring | null
rawobject
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/high-demand-periods
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/high-demand-periods" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Schedule a budget increase

POST/ads/accounts/{adAccountId}/high-demand-periods

Access: writeIdempotency-KeyZernio: POST /v1/ads/high-demand-periods

Try it with MCPAsk your agent to call create-high-demand-period (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 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

campaign_idstring

1–64 characters

ad_set_idstring

1–64 characters

budget_valuenumberrequired
budget_value_typestringrequired

ABSOLUTEMULTIPLIER

time_startstring | integerrequired

ISO 8601 date-time or unix seconds

time_endstring | integerrequired

ISO 8601 date-time or unix seconds

recurrence_typestring

ONE_TIMEWEEKLYMONTHLY

Returns object

objectstringrequired

high_demand_period

idstring
target_idstring
budget_valuenumber | null
budget_value_typestring | null
time_startstring (date-time) | null
time_endstring (date-time) | null
recurrence_typestring | null
rawobject

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/accounts/{adAccountId}/high-demand-periods
curl -X POST "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/high-demand-periods" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "campaign_id": "string",
    "budget_value": 1.5,
    "budget_value_type": "ABSOLUTE",
    "time_start": "string",
    "time_end": "string"
  }'
Response · 201

List value rule sets

GET/ads/accounts/{adAccountId}/value-rule-sets

Access: readZernio: GET /v1/ads/value-rule-sets

Try it with MCPAsk your agent to call list-value-rule-sets (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Query parameters

limitintegerdefault: 25

Items per page (max 100)

1–100

cursorstring

next_cursor from the previous page

≤ 4096 characters

afterstring

Alias of cursor

≤ 4096 characters

Returns object

objectstring

list

dataarray of object
Show 4 item attributes
objectstringrequired

value_rule_set

idstring
namestring | null
rulesarray of object
Show 6 item attributes
idstring | null
namestring | null
adjust_signstring | null
adjust_valuenumber | null
statusstring | null
criteriaarray of object
Show 5 item attributes
idstring | null
criteria_typestring | null
operatorstring | null
criteria_valuesarray of string
criteria_value_typesarray of string
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/value-rule-sets
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/value-rule-sets" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a value rule set

POST/ads/accounts/{adAccountId}/value-rule-sets

Access: writeIdempotency-KeyZernio: POST /v1/ads/value-rule-sets

Try it with MCPAsk your agent to call create-value-rule-set (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 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

namestringrequired

1–100 characters

rulesarray of objectrequired

1–50 items

Show 6 item attributes
idstring | null

≤ 64 characters

namestringrequired

1–100 characters

adjust_signstringrequired

INCREASEDECREASE

adjust_valueintegerrequired

1–1000

statusstring

1–32 characters

criteriaarray of objectrequired

≥ 1 items

Show 5 item attributes
idstring | null

≤ 64 characters

criteria_typestringrequired

AGEGENDEROS_TYPEDEVICE_PLATFORMLOCATIONPLACEMENTOMNI_CHANNELAUDIENCE_LABEL

operatorstring

CONTAINS

criteria_valuesarray of stringrequired

≥ 1 items

criteria_value_typesarray of string

Returns object

objectstringrequired

value_rule_set

idstring
namestring | null
rulesarray of object
Show 6 item attributes
idstring | null
namestring | null
adjust_signstring | null
adjust_valuenumber | null
statusstring | null
criteriaarray of object
Show 5 item attributes
idstring | null
criteria_typestring | null
operatorstring | null
criteria_valuesarray of string
criteria_value_typesarray of string

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/accounts/{adAccountId}/value-rule-sets
curl -X POST "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/value-rule-sets" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "rules": [
      {
        "name": "string",
        "adjust_sign": "INCREASE",
        "adjust_value": 1,
        "criteria": [
          {
            "criteria_type": "AGE",
            "criteria_values": []
          }
        ]
      }
    ]
  }'
Response · 201

Read a value rule set

GET/ads/accounts/{adAccountId}/value-rule-sets/{valueRuleSetId}

Access: readZernio: GET /v1/ads/value-rule-sets/{valueRuleSetId}

Try it with MCPAsk your agent to call get-value-rule-set (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

valueRuleSetIdstringrequired

1–256 characters

Returns object

objectstringrequired

value_rule_set

idstring
namestring | null
rulesarray of object
Show 6 item attributes
idstring | null
namestring | null
adjust_signstring | null
adjust_valuenumber | null
statusstring | null
criteriaarray of object
Show 5 item attributes
idstring | null
criteria_typestring | null
operatorstring | null
criteria_valuesarray of string
criteria_value_typesarray of string

Responses

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

Replace a value rule set

PATCH/ads/accounts/{adAccountId}/value-rule-sets/{valueRuleSetId}

Full replace: keep a rule or criterion by echoing its id, omit it to delete it.

Access: writeZernio: PUT /v1/ads/value-rule-sets/{valueRuleSetId}

Try it with MCPAsk your agent to call replace-value-rule-set (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

valueRuleSetIdstringrequired

1–256 characters

Body object

namestringrequired

1–100 characters

rulesarray of objectrequired

1–50 items

Show 6 item attributes
idstring | null

≤ 64 characters

namestringrequired

1–100 characters

adjust_signstringrequired

INCREASEDECREASE

adjust_valueintegerrequired

1–1000

statusstring

1–32 characters

criteriaarray of objectrequired

≥ 1 items

Show 5 item attributes
idstring | null

≤ 64 characters

criteria_typestringrequired

AGEGENDEROS_TYPEDEVICE_PLATFORMLOCATIONPLACEMENTOMNI_CHANNELAUDIENCE_LABEL

operatorstring

CONTAINS

criteria_valuesarray of stringrequired

≥ 1 items

criteria_value_typesarray of string

Returns object

objectstringrequired

value_rule_set

idstring
namestring | null
rulesarray of object
Show 6 item attributes
idstring | null
namestring | null
adjust_signstring | null
adjust_valuenumber | null
statusstring | null
criteriaarray of object
Show 5 item attributes
idstring | null
criteria_typestring | null
operatorstring | null
criteria_valuesarray of string
criteria_value_typesarray of string

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/accounts/{adAccountId}/value-rule-sets/{valueRuleSetId}
curl -X PATCH "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/value-rule-sets/VALUE_RULE_SET_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "rules": [
      {
        "name": "string",
        "adjust_sign": "INCREASE",
        "adjust_value": 1,
        "criteria": [
          {
            "criteria_type": "AGE",
            "criteria_values": []
          }
        ]
      }
    ]
  }'
Response · 200

Delete a value rule set

DELETE/ads/accounts/{adAccountId}/value-rule-sets/{valueRuleSetId}

Access: writeZernio: DELETE /v1/ads/value-rule-sets/{valueRuleSetId}

Try it with MCPAsk your agent to call delete-value-rule-set (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

valueRuleSetIdstringrequired

1–256 characters

Returns object

objectstringrequired

value_rule_set

idstringrequired
deletedbooleanrequired

Responses

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

List negative keyword lists

GET/ads/accounts/{adAccountId}/negative-keyword-lists

Google Ads shared negative keyword lists.

Access: readZernio: GET /v1/ads/accounts/negative-keyword-lists

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

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Returns object

objectstring

list

dataarray of object
Show 9 item attributes
objectstringrequired

negative_keyword_list

idstring
resource_namestring | null
namestring | null
member_countinteger
reference_countinteger
keywordsarray of object
Show 3 item attributes
criterion_idstring
textstring
match_typestring
createdinteger
removedinteger
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/negative-keyword-lists
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/negative-keyword-lists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a negative keyword list

POST/ads/accounts/{adAccountId}/negative-keyword-lists

Access: writeIdempotency-KeyZernio: POST /v1/ads/accounts/negative-keyword-lists

Try it with MCPAsk your agent to call create-negative-keyword-list (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 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

namestringrequired

1–255 characters

keywordsarray of string | object

≤ 5000 items

One of 2 shapes

Option 1 string

Option 2 object

textstringrequired

1–80 characters

match_typestring

exactphrasebroad

Returns object

objectstringrequired

negative_keyword_list

idstring
resource_namestring | null
namestring | null
member_countinteger
reference_countinteger
keywordsarray of object
Show 3 item attributes
criterion_idstring
textstring
match_typestring
createdinteger
removedinteger

Responses

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

Get a negative keyword list

GET/ads/accounts/{adAccountId}/negative-keyword-lists/{listId}

Access: readZernio: GET /v1/ads/accounts/negative-keyword-lists/{listId}

Try it with MCPAsk your agent to call get-negative-keyword-list (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

listIdstringrequired

1–256 characters

Returns object

objectstringrequired

negative_keyword_list

idstring
resource_namestring | null
namestring | null
member_countinteger
reference_countinteger
keywordsarray of object
Show 3 item attributes
criterion_idstring
textstring
match_typestring
createdinteger
removedinteger

Responses

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

Rename a negative keyword list

PATCH/ads/accounts/{adAccountId}/negative-keyword-lists/{listId}

Access: writeZernio: PUT /v1/ads/accounts/negative-keyword-lists/{listId}

Try it with MCPAsk your agent to call rename-negative-keyword-list (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

listIdstringrequired

1–256 characters

Body object

namestringrequired

1–255 characters

Returns object

objectstringrequired

negative_keyword_list

idstring
resource_namestring | null
namestring | null
member_countinteger
reference_countinteger
keywordsarray of object
Show 3 item attributes
criterion_idstring
textstring
match_typestring
createdinteger
removedinteger

Responses

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

Delete a negative keyword list

DELETE/ads/accounts/{adAccountId}/negative-keyword-lists/{listId}

Access: writeZernio: DELETE /v1/ads/accounts/negative-keyword-lists/{listId}

Try it with MCPAsk your agent to call delete-negative-keyword-list (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

listIdstringrequired

1–256 characters

Returns object

objectstringrequired

negative_keyword_list

idstringrequired
deletedbooleanrequired

Responses

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

Replace negative list keywords

PATCH/ads/accounts/{adAccountId}/negative-keyword-lists/{listId}/keywords

Diffs by normalized text + match type; [] clears the list. Affects every campaign using it.

Access: writeZernio: PUT /v1/ads/accounts/negative-keyword-lists/{listId}/keywords

Try it with MCPAsk your agent to call replace-negative-keyword-list-keywords (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

listIdstringrequired

1–256 characters

Body object

keywordsarray of string | objectrequired

≤ 5000 items

One of 2 shapes

Option 1 string

Option 2 object

textstringrequired

1–80 characters

match_typestring

exactphrasebroad

Returns object

objectstringrequired

negative_keyword_list

idstring
resource_namestring | null
namestring | null
member_countinteger
reference_countinteger
keywordsarray of object
Show 3 item attributes
criterion_idstring
textstring
match_typestring
createdinteger
removedinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/accounts/{adAccountId}/negative-keyword-lists/{listId}/keywords
curl -X PATCH "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/negative-keyword-lists/LIST_ID/keywords" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keywords": [
      "string"
    ]
  }'
Response · 200

List account callouts

GET/ads/accounts/{adAccountId}/callouts

Google Ads callouts attached at account level.

Access: readZernio: GET /v1/ads/accounts/callouts

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

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Returns object

objectstring

list

dataarray of object
Show 6 item attributes
objectstringrequired

callout

idstring
statusstring | null
resource_namestring | null
customer_asset_resource_namestring | null
textstring
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/callouts
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/callouts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Add account callouts

POST/ads/accounts/{adAccountId}/callouts

Access: writeIdempotency-KeyZernio: POST /v1/ads/accounts/callouts

Try it with MCPAsk your agent to call add-account-callouts (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 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

calloutsarray of stringrequired

1–20 items

Returns object

objectstring

list

dataarray of object
Show 6 item attributes
objectstringrequired

callout

idstring
statusstring | null
resource_namestring | null
customer_asset_resource_namestring | null
textstring
pageinteger
limitinteger
totalinteger | null
has_moreboolean
next_page_urlstring | null
previous_page_urlstring | null
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/accounts/{adAccountId}/callouts
curl -X POST "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/callouts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "callouts": [
      "string"
    ]
  }'
Response · 201

Update account callouts

PATCH/ads/accounts/{adAccountId}/callouts

Edits existing callout assets in place (shared assets change everywhere they are used).

Access: writeZernio: PUT /v1/ads/accounts/callouts

Try it with MCPAsk your agent to call update-account-callouts (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Body object

updatesarray of objectrequired

≥ 1 items

Show 2 item attributes
asset_idstringrequired

1–32 characters

textstringrequired

1–25 characters

Returns object

objectstringrequired

asset_update_result

updatedinteger

Responses

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

Remove an account callout

DELETE/ads/accounts/{adAccountId}/callouts/{assetId}

Detaches it from the account level only; campaign and ad group attachments stay.

Access: writeZernio: DELETE /v1/ads/accounts/callouts

Try it with MCPAsk your agent to call remove-account-callout (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

assetIdstringrequired

1–256 characters

Returns object

objectstringrequired

callout

idstringrequired
deletedbooleanrequired

Responses

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

Google Ads sitelinks attached at account level.

Access: readZernio: GET /v1/ads/accounts/sitelinks

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

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Returns object

objectstring

list

dataarray of object
Show 9 item attributes
objectstringrequired

sitelink

idstring
statusstring | null
resource_namestring | null
customer_asset_resource_namestring | null
textstring
link_urlstring | null
description1string | null
description2string | null
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/sitelinks
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/sitelinks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
POST/ads/accounts/{adAccountId}/sitelinks

Access: writeIdempotency-KeyZernio: POST /v1/ads/accounts/sitelinks

Try it with MCPAsk your agent to call add-account-sitelinks (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 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

sitelinksarray of objectrequired

1–20 items

Show 4 item attributes
textstringrequired

1–25 characters

link_urlstring (uri)required

≤ 2048 characters

description1string

1–35 characters

description2string

1–35 characters

Returns object

objectstring

list

dataarray of object
Show 9 item attributes
objectstringrequired

sitelink

idstring
statusstring | null
resource_namestring | null
customer_asset_resource_namestring | null
textstring
link_urlstring | null
description1string | null
description2string | null
pageinteger
limitinteger
totalinteger | null
has_moreboolean
next_page_urlstring | null
previous_page_urlstring | null
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/accounts/{adAccountId}/sitelinks
curl -X POST "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/sitelinks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "sitelinks": [
      {
        "text": "string",
        "link_url": "https://example.com"
      }
    ]
  }'
Response · 201
PATCH/ads/accounts/{adAccountId}/sitelinks

Edits existing sitelink assets in place (shared assets change everywhere they are used).

Access: writeZernio: PUT /v1/ads/accounts/sitelinks

Try it with MCPAsk your agent to call update-account-sitelinks (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Body object

updatesarray of objectrequired

≥ 1 items

Show 5 item attributes
asset_idstringrequired

1–32 characters

textstring

1–25 characters

link_urlstring (uri)

≤ 2048 characters

description1string

1–35 characters

description2string

1–35 characters

Returns object

objectstringrequired

asset_update_result

updatedinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/accounts/{adAccountId}/sitelinks
curl -X PATCH "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/sitelinks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "updates": [
      {
        "asset_id": "string",
        "text": "string"
      }
    ]
  }'
Response · 200
DELETE/ads/accounts/{adAccountId}/sitelinks/{assetId}

Detaches it from the account level only; campaign and ad group attachments stay.

Access: writeZernio: DELETE /v1/ads/accounts/sitelinks

Try it with MCPAsk your agent to call remove-account-sitelink (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

assetIdstringrequired

1–256 characters

Returns object

objectstringrequired

sitelink

idstringrequired
deletedbooleanrequired

Responses

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

List account structured snippets

GET/ads/accounts/{adAccountId}/structured-snippets

Google Ads structured snippets attached at account level.

Access: readZernio: GET /v1/ads/accounts/structured-snippets

Try it with MCPAsk your agent to call list-account-structured-snippets (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Returns object

objectstring

list

dataarray of object
Show 7 item attributes
objectstringrequired

structured_snippet

idstring
statusstring | null
resource_namestring | null
customer_asset_resource_namestring | null
headerstring
valuesarray of string
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/structured-snippets
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/structured-snippets" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Add account structured snippets

POST/ads/accounts/{adAccountId}/structured-snippets

Access: writeIdempotency-KeyZernio: POST /v1/ads/accounts/structured-snippets

Try it with MCPAsk your agent to call add-account-structured-snippets (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 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

structured_snippetsarray of objectrequired

1–20 items

Show 2 item attributes
headerstringrequired

AmenitiesBrandsCoursesDegree programsDestinationsFeatured hotelsInsurance coverageModelsNeighborhoodsService catalogShowsStylesTypes

valuesarray of stringrequired

3–10 items

Returns object

objectstring

list

dataarray of object
Show 7 item attributes
objectstringrequired

structured_snippet

idstring
statusstring | null
resource_namestring | null
customer_asset_resource_namestring | null
headerstring
valuesarray of string
pageinteger
limitinteger
totalinteger | null
has_moreboolean
next_page_urlstring | null
previous_page_urlstring | null
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/accounts/{adAccountId}/structured-snippets
curl -X POST "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/structured-snippets" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "structured_snippets": [
      {
        "header": "Amenities",
        "values": [
          "string"
        ]
      }
    ]
  }'
Response · 201

Update account structured snippets

PATCH/ads/accounts/{adAccountId}/structured-snippets

Edits existing structured snippet assets in place (shared assets change everywhere they are used).

Access: writeZernio: PUT /v1/ads/accounts/structured-snippets

Try it with MCPAsk your agent to call update-account-structured-snippets (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Body object

updatesarray of objectrequired

≥ 1 items

Show 3 item attributes
asset_idstringrequired

1–32 characters

headerstring

AmenitiesBrandsCoursesDegree programsDestinationsFeatured hotelsInsurance coverageModelsNeighborhoodsService catalogShowsStylesTypes

valuesarray of string

3–10 items

Returns object

objectstringrequired

asset_update_result

updatedinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/accounts/{adAccountId}/structured-snippets
curl -X PATCH "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/structured-snippets" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "updates": [
      {
        "asset_id": "string",
        "header": "Amenities"
      }
    ]
  }'
Response · 200

Remove an account structured snippet

DELETE/ads/accounts/{adAccountId}/structured-snippets/{assetId}

Detaches it from the account level only; campaign and ad group attachments stay.

Access: writeZernio: DELETE /v1/ads/accounts/structured-snippets

Try it with MCPAsk your agent to call remove-account-structured-snippet (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

assetIdstringrequired

1–256 characters

Returns object

objectstringrequired

structured_snippet

idstringrequired
deletedbooleanrequired

Responses

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

List tracking tags

GET/ads/accounts/{adAccountId}/tracking-tags

Pixels and measurement tags of the ad account (install code omitted).

Access: readZernio: GET /v1/accounts/{accountId}/tracking-tags

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

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Returns object

objectstring

list

dataarray of object
Show 16 item attributes
objectstringrequired

tracking_tag

idstring
site_tag_idstring | null
platformstring
kindstring
namestring | null
statusstring
codestring | null
last_fired_atstring (date-time) | null
is_unavailableboolean
created_atstring (date-time) | null
automatic_matching_fieldsarray of string
owner_business_idstring | null
owner_ad_account_idstring | null
auto_taggingboolean | null
eventsarray of object
Show 15 item attributes
objectstring

tracking_tag_event

idstring
namestring
typestring | null
site_eventstring | null
site_event_idstring | null
statusstring | null
default_valuenumber | null
currencystring | null
click_window_daysnumber | null
view_window_daysnumber | null
url_containsstring | null
always_use_default_valueboolean | null
primaryboolean | null
counting_typestring | null
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/tracking-tags
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tracking-tags" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a tracking tag

POST/ads/accounts/{adAccountId}/tracking-tags

Not idempotent on the networks: send an Idempotency-Key and never retry blindly.

Access: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/tracking-tags

Try it with MCPAsk your agent to call create-tracking-tag (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 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

namestringrequired

1–100 characters

automatic_matching_fieldsarray of string
default_event_typestring

1–64 characters

domainstring

1–255 characters

partner_namestring

1–64 characters

Returns object

objectstringrequired

tracking_tag

idstring
site_tag_idstring | null
platformstring
kindstring
namestring | null
statusstring
codestring | null
last_fired_atstring (date-time) | null
is_unavailableboolean
created_atstring (date-time) | null
automatic_matching_fieldsarray of string
owner_business_idstring | null
owner_ad_account_idstring | null
auto_taggingboolean | null
eventsarray of object
Show 15 item attributes
objectstring

tracking_tag_event

idstring
namestring
typestring | null
site_eventstring | null
site_event_idstring | null
statusstring | null
default_valuenumber | null
currencystring | null
click_window_daysnumber | null
view_window_daysnumber | null
url_containsstring | null
always_use_default_valueboolean | null
primaryboolean | null
counting_typestring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/accounts/{adAccountId}/tracking-tags
curl -X POST "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tracking-tags" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "automatic_matching_fields": [
      "em"
    ],
    "default_event_type": "string",
    "domain": "string",
    "partner_name": "string"
  }'
Response · 201

Get a tracking tag

GET/ads/accounts/{adAccountId}/tracking-tags/{tagId}

The tag with its install code and conversion events.

Access: readZernio: GET /v1/accounts/{accountId}/tracking-tags/{tagId}

Try it with MCPAsk your agent to call get-tracking-tag (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

tagIdstringrequired

1–256 characters

Returns object

objectstringrequired

tracking_tag

idstring
site_tag_idstring | null
platformstring
kindstring
namestring | null
statusstring
codestring | null
last_fired_atstring (date-time) | null
is_unavailableboolean
created_atstring (date-time) | null
automatic_matching_fieldsarray of string
owner_business_idstring | null
owner_ad_account_idstring | null
auto_taggingboolean | null
eventsarray of object
Show 15 item attributes
objectstring

tracking_tag_event

idstring
namestring
typestring | null
site_eventstring | null
site_event_idstring | null
statusstring | null
default_valuenumber | null
currencystring | null
click_window_daysnumber | null
view_window_daysnumber | null
url_containsstring | null
always_use_default_valueboolean | null
primaryboolean | null
counting_typestring | null

Responses

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

Update a tracking tag

PATCH/ads/accounts/{adAccountId}/tracking-tags/{tagId}

Access: writeZernio: PATCH /v1/accounts/{accountId}/tracking-tags/{tagId}

Try it with MCPAsk your agent to call update-tracking-tag (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

tagIdstringrequired

1–256 characters

Body object

namestring

1–100 characters

enable_automatic_matchingboolean
automatic_matching_fieldsarray of string
first_party_cookie_statusstring

emptyfirst_party_cookie_disabledfirst_party_cookie_enabled

data_use_settingstring

advertising_and_analyticsanalytics_onlyempty

auto_taggingboolean

Returns object

objectstringrequired

tracking_tag

idstring
site_tag_idstring | null
platformstring
kindstring
namestring | null
statusstring
codestring | null
last_fired_atstring (date-time) | null
is_unavailableboolean
created_atstring (date-time) | null
automatic_matching_fieldsarray of string
owner_business_idstring | null
owner_ad_account_idstring | null
auto_taggingboolean | null
eventsarray of object
Show 15 item attributes
objectstring

tracking_tag_event

idstring
namestring
typestring | null
site_eventstring | null
site_event_idstring | null
statusstring | null
default_valuenumber | null
currencystring | null
click_window_daysnumber | null
view_window_daysnumber | null
url_containsstring | null
always_use_default_valueboolean | null
primaryboolean | null
counting_typestring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/accounts/{adAccountId}/tracking-tags/{tagId}
curl -X PATCH "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tracking-tags/TAG_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "enable_automatic_matching": true,
    "automatic_matching_fields": [
      "em"
    ],
    "first_party_cookie_status": "empty",
    "data_use_setting": "advertising_and_analytics"
  }'
Response · 200

List accounts a tag is shared with

GET/ads/accounts/{adAccountId}/tracking-tags/{tagId}/shared-accounts

Access: readZernio: GET /v1/accounts/{accountId}/tracking-tags/{tagId}/shared-accounts

Try it with MCPAsk your agent to call list-tracking-tag-shared-accounts (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

tagIdstringrequired

1–256 characters

Query parameters

business_idstring

1–64 characters

Returns object

objectstring

list

dataarray of object
Show 5 item attributes
objectstringrequired

tracking_tag_shared_account

idstring
namestring | null
business_idstring | null
rolestring | null
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/tracking-tags/{tagId}/shared-accounts
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tracking-tags/TAG_ID/shared-accounts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Share a tag with an ad account

POST/ads/accounts/{adAccountId}/tracking-tags/{tagId}/shared-accounts

Access: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/tracking-tags/{tagId}/shared-accounts

Try it with MCPAsk your agent to call share-tracking-tag (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

tagIdstringrequired

1–256 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_idstringrequired

1–256 characters

business_idstring

1–64 characters

Returns object

objectstringrequired

tracking_tag_shared_account

idstring
namestring | null
business_idstring | null
rolestring | null

Responses

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

Stop sharing a tag with an account

DELETE/ads/accounts/{adAccountId}/tracking-tags/{tagId}/shared-accounts/{sharedAccountId}

Access: writeZernio: DELETE /v1/accounts/{accountId}/tracking-tags/{tagId}/shared-accounts

Try it with MCPAsk your agent to call unshare-tracking-tag (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

tagIdstringrequired

1–256 characters

sharedAccountIdstringrequired

1–256 characters

Query parameters

business_idstring

1–64 characters

Returns object

objectstringrequired

tracking_tag_shared_account

idstringrequired
deletedbooleanrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/ads/accounts/{adAccountId}/tracking-tags/{tagId}/shared-accounts/{sharedAccountId}
curl -X DELETE "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tracking-tags/TAG_ID/shared-accounts/SHARED_ACCOUNT_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

List conversion events of a tag

GET/ads/accounts/{adAccountId}/tracking-tags/{tagId}/events

Access: readZernio: GET /v1/accounts/{accountId}/tracking-tags/{tagId}/events

Try it with MCPAsk your agent to call list-tracking-tag-events (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

tagIdstringrequired

1–256 characters

Returns object

objectstring

list

dataarray of object
Show 15 item attributes
objectstringrequired

tracking_tag_event

idstring
namestring
typestring | null
site_eventstring | null
site_event_idstring | null
statusstring | null
default_valuenumber | null
currencystring | null
click_window_daysnumber | null
view_window_daysnumber | null
url_containsstring | null
always_use_default_valueboolean | null
primaryboolean | null
counting_typestring | null
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/tracking-tags/{tagId}/events
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tracking-tags/TAG_ID/events" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a conversion event

POST/ads/accounts/{adAccountId}/tracking-tags/{tagId}/events

Not idempotent on the networks. A field the network does not store → 422.

Access: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/tracking-tags/{tagId}/events

Try it with MCPAsk your agent to call create-tracking-tag-event (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

tagIdstringrequired

1–256 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

namestringrequired

1–100 characters

typestring

1–64 characters

site_eventstring

page_viewview_contentadd_to_cartsearchinitiate_checkoutadd_payment_infopurchase

enabledboolean
default_valuenumber
currencystring

pattern ^[A-Za-z]{3}$

click_window_daysinteger

1–365

view_window_daysinteger

0–365

url_containsstring

1–500 characters

counting_typestring

oneevery

Returns object

objectstringrequired

tracking_tag_event

idstring
namestring
typestring | null
site_eventstring | null
site_event_idstring | null
statusstring | null
default_valuenumber | null
currencystring | null
click_window_daysnumber | null
view_window_daysnumber | null
url_containsstring | null
always_use_default_valueboolean | null
primaryboolean | null
counting_typestring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/accounts/{adAccountId}/tracking-tags/{tagId}/events
curl -X POST "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tracking-tags/TAG_ID/events" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "type": "string",
    "site_event": "page_view",
    "enabled": true,
    "default_value": 0
  }'
Response · 201

Update a conversion event

PATCH/ads/accounts/{adAccountId}/tracking-tags/{tagId}/events/{eventId}

Access: writeZernio: PATCH /v1/accounts/{accountId}/tracking-tags/{tagId}/events/{eventId}

Try it with MCPAsk your agent to call update-tracking-tag-event (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

tagIdstringrequired

1–256 characters

eventIdstringrequired

1–256 characters

Body object

namestring

1–100 characters

typestring

1–64 characters

site_eventstring

page_viewview_contentadd_to_cartsearchinitiate_checkoutadd_payment_infopurchase

enabledboolean
default_valuenumber
currencystring

pattern ^[A-Za-z]{3}$

click_window_daysinteger

1–365

view_window_daysinteger

0–365

url_containsstring

1–500 characters

counting_typestring

oneevery

Returns object

objectstringrequired

tracking_tag_event

idstring
namestring
typestring | null
site_eventstring | null
site_event_idstring | null
statusstring | null
default_valuenumber | null
currencystring | null
click_window_daysnumber | null
view_window_daysnumber | null
url_containsstring | null
always_use_default_valueboolean | null
primaryboolean | null
counting_typestring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/accounts/{adAccountId}/tracking-tags/{tagId}/events/{eventId}
curl -X PATCH "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tracking-tags/TAG_ID/events/EVENT_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "type": "string",
    "site_event": "page_view",
    "enabled": true,
    "default_value": 0
  }'
Response · 200

Delete a conversion event

DELETE/ads/accounts/{adAccountId}/tracking-tags/{tagId}/events/{eventId}

Archives or disables it on networks without a hard delete (state).

Access: writeZernio: DELETE /v1/accounts/{accountId}/tracking-tags/{tagId}/events/{eventId}

Try it with MCPAsk your agent to call delete-tracking-tag-event (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

tagIdstringrequired

1–256 characters

eventIdstringrequired

1–256 characters

Returns object

objectstring

tracking_tag_event

idstring
deletedboolean
statestring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/ads/accounts/{adAccountId}/tracking-tags/{tagId}/events/{eventId}
curl -X DELETE "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tracking-tags/TAG_ID/events/EVENT_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

List tag users

GET/ads/accounts/{adAccountId}/tracking-tags/{tagId}/users

Access: readZernio: GET /v1/accounts/{accountId}/tracking-tags/{tagId}/users

Try it with MCPAsk your agent to call list-tracking-tag-users (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

tagIdstringrequired

1–256 characters

Returns object

objectstring

list

dataarray of object
Show 4 item attributes
objectstringrequired

tracking_tag_user

idstring
namestring | null
tasksarray of string
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/tracking-tags/{tagId}/users
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tracking-tags/TAG_ID/users" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Assign a user to a tag

POST/ads/accounts/{adAccountId}/tracking-tags/{tagId}/users

Access: adminIdempotency-KeyZernio: POST /v1/accounts/{accountId}/tracking-tags/{tagId}/users

Try it with MCPAsk your agent to call assign-tracking-tag-user (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

tagIdstringrequired

1–256 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

user_idstringrequired

1–64 characters

tasksarray of stringrequired

≥ 1 items

business_idstring

1–64 characters

Returns object

objectstringrequired

tracking_tag_user

idstring
namestring | null
tasksarray of string

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/accounts/{adAccountId}/tracking-tags/{tagId}/users
curl -X POST "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tracking-tags/TAG_ID/users" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "string",
    "tasks": [
      "AA_ANALYZE"
    ],
    "business_id": "string"
  }'
Response · 201

Remove a user from a tag

DELETE/ads/accounts/{adAccountId}/tracking-tags/{tagId}/users/{userId}

Access: adminZernio: DELETE /v1/accounts/{accountId}/tracking-tags/{tagId}/users/{userId}

Try it with MCPAsk your agent to call remove-tracking-tag-user (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

tagIdstringrequired

1–256 characters

userIdstringrequired

1–256 characters

Returns object

objectstringrequired

tracking_tag_user

idstringrequired
deletedbooleanrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/ads/accounts/{adAccountId}/tracking-tags/{tagId}/users/{userId}
curl -X DELETE "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tracking-tags/TAG_ID/users/USER_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

List partner businesses of a tag

GET/ads/accounts/{adAccountId}/tracking-tags/{tagId}/partners

Access: readZernio: GET /v1/accounts/{accountId}/tracking-tags/{tagId}/partners

Try it with MCPAsk your agent to call list-tracking-tag-partners (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

tagIdstringrequired

1–256 characters

Returns object

objectstring

list

dataarray of object
Show 3 item attributes
objectstringrequired

tracking_tag_partner

idstring
namestring | null
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/tracking-tags/{tagId}/partners
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tracking-tags/TAG_ID/partners" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Get tag diagnostics

GET/ads/accounts/{adAccountId}/tracking-tags/{tagId}/diagnostics

Access: readZernio: GET /v1/accounts/{accountId}/tracking-tags/{tagId}/diagnostics

Try it with MCPAsk your agent to call get-tracking-tag-diagnostics (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

tagIdstringrequired

1–256 characters

Returns object

objectstring

list

dataarray of object
Show 6 item attributes
objectstringrequired

tracking_tag_diagnostic

keystring
titlestring
descriptionstring | null
resultstring
action_urlstring | null
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/tracking-tags/{tagId}/diagnostics
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tracking-tags/TAG_ID/diagnostics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Get aggregated tag stats

GET/ads/accounts/{adAccountId}/tracking-tags/{tagId}/stats

Access: readZernio: GET /v1/accounts/{accountId}/tracking-tags/{tagId}/stats

Try it with MCPAsk your agent to call get-tracking-tag-stats (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

tagIdstringrequired

1–256 characters

Query parameters

aggregationstring

eventhosturlurl_by_rulepixel_firedevice_typedevice_osbrowser_typehad_piicustom_data_fieldmatch_keysevent_sourceevent_detection_methodevent_processing_resultsevent_total_countsevent_value_count

start_timestring | integer

ISO 8601 date-time or unix seconds

end_timestring | integer

ISO 8601 date-time or unix seconds

Returns object

objectstringrequired

tracking_tag_stats

tag_idstring
platformstring
aggregationstring | null
start_timestring (date-time) | null
end_timestring (date-time) | null
rowsarray of object

Responses

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

List conversion actions

GET/ads/accounts/{adAccountId}/conversion-actions

Google Ads conversion actions with their tag snippets.

Access: readZernio: GET /v1/ads/conversions/actions

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

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Query parameters

typestring

1–64 characters

Returns object

objectstring

list

dataarray of object
Show 16 item attributes
objectstringrequired

conversion_action

idstring
namestring | null
typestring | null
statusstring | null
categorystring | null
originstring | null
primary_for_goalboolean | null
default_valuenumber | null
default_currencystring | null
always_use_default_valueboolean | null
counting_typestring | null
click_through_lookback_window_daysnumber | null
view_through_lookback_window_daysnumber | null
resource_namestring | null
tag_snippetsarray of object
Show 4 item attributes
typestring | null
page_formatstring | null
global_site_tagstring | null
event_snippetstring | null
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/conversion-actions
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/conversion-actions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a website conversion action

POST/ads/accounts/{adAccountId}/conversion-actions

Access: writeIdempotency-KeyZernio: POST /v1/ads/conversions/actions

Try it with MCPAsk your agent to call create-conversion-action (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 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

namestringrequired

1–255 characters

categorystring

DEFAULTPAGE_VIEWPURCHASESIGNUPDOWNLOADADD_TO_CARTBEGIN_CHECKOUTSUBSCRIBE_PAIDPHONE_CALL_LEADIMPORTED_LEADSUBMIT_LEAD_FORMBOOK_APPOINTMENTREQUEST_QUOTEGET_DIRECTIONSOUTBOUND_CLICKCONTACTENGAGEMENTSTORE_VISITSTORE_SALEQUALIFIED_LEADCONVERTED_LEAD

default_valuenumber
default_currencystring

pattern ^[A-Za-z]{3}$

always_use_default_valueboolean
counting_typestring

ONE_PER_CLICKMANY_PER_CLICK

click_through_lookback_window_daysinteger

1–90

view_through_lookback_window_daysinteger

1–30

primary_for_goalboolean
typestring

WEBPAGE

Returns object

objectstringrequired

conversion_action

idstring
namestring | null
typestring | null
statusstring | null
categorystring | null
originstring | null
primary_for_goalboolean | null
default_valuenumber | null
default_currencystring | null
always_use_default_valueboolean | null
counting_typestring | null
click_through_lookback_window_daysnumber | null
view_through_lookback_window_daysnumber | null
resource_namestring | null
tag_snippetsarray of object
Show 4 item attributes
typestring | null
page_formatstring | null
global_site_tagstring | null
event_snippetstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/accounts/{adAccountId}/conversion-actions
curl -X POST "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/conversion-actions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "category": "DEFAULT",
    "default_value": 0,
    "default_currency": "string",
    "always_use_default_value": true
  }'
Response · 201

Update a conversion action

PATCH/ads/accounts/{adAccountId}/conversion-actions/{actionId}

Access: writeZernio: PATCH /v1/ads/conversions/actions/{actionId}

Try it with MCPAsk your agent to call update-conversion-action (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

actionIdstringrequired

1–256 characters

Body object

namestring

1–255 characters

categorystring

DEFAULTPAGE_VIEWPURCHASESIGNUPDOWNLOADADD_TO_CARTBEGIN_CHECKOUTSUBSCRIBE_PAIDPHONE_CALL_LEADIMPORTED_LEADSUBMIT_LEAD_FORMBOOK_APPOINTMENTREQUEST_QUOTEGET_DIRECTIONSOUTBOUND_CLICKCONTACTENGAGEMENTSTORE_VISITSTORE_SALEQUALIFIED_LEADCONVERTED_LEAD

default_valuenumber
default_currencystring

pattern ^[A-Za-z]{3}$

always_use_default_valueboolean
counting_typestring

ONE_PER_CLICKMANY_PER_CLICK

click_through_lookback_window_daysinteger

1–90

view_through_lookback_window_daysinteger

1–30

primary_for_goalboolean
statusstring

ENABLEDREMOVED

Returns object

objectstringrequired

conversion_action

idstring
namestring | null
typestring | null
statusstring | null
categorystring | null
originstring | null
primary_for_goalboolean | null
default_valuenumber | null
default_currencystring | null
always_use_default_valueboolean | null
counting_typestring | null
click_through_lookback_window_daysnumber | null
view_through_lookback_window_daysnumber | null
resource_namestring | null
tag_snippetsarray of object
Show 4 item attributes
typestring | null
page_formatstring | null
global_site_tagstring | null
event_snippetstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/accounts/{adAccountId}/conversion-actions/{actionId}
curl -X PATCH "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/conversion-actions/ACTION_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "category": "DEFAULT",
    "default_value": 0,
    "default_currency": "string",
    "always_use_default_value": true
  }'
Response · 200

List account conversion goals

GET/ads/accounts/{adAccountId}/conversion-goals

Access: readZernio: GET /v1/ads/conversions/goals

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

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Returns object

objectstring

list

dataarray of object
Show 6 item attributes
objectstringrequired

conversion_goal

categorystring | null
originstring | null
biddableboolean
resource_namestring | null
conversion_actionsarray of object
Show 4 item attributes
idstring
namestring | null
statusstring | null
primary_for_goalboolean
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/conversion-goals
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/conversion-goals" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Update account conversion goals

PATCH/ads/accounts/{adAccountId}/conversion-goals

Access: writeZernio: PATCH /v1/ads/conversions/goals

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

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Body object

goalsarray of objectrequired

1–100 items

Show 3 item attributes
categorystringrequired

1–64 characters

originstringrequired

1–64 characters

biddablebooleanrequired

Returns object

objectstring

list

dataarray of object
Show 6 item attributes
objectstringrequired

conversion_goal

categorystring | null
originstring | null
biddableboolean
resource_namestring | null
conversion_actionsarray of object
Show 4 item attributes
idstring
namestring | null
statusstring | null
primary_for_goalboolean
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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
PATCH/ads/accounts/{adAccountId}/conversion-goals
curl -X PATCH "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/conversion-goals" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "goals": [
      {
        "category": "string",
        "origin": "string",
        "biddable": true
      }
    ]
  }'
Response · 200

List custom conversion goals

GET/ads/accounts/{adAccountId}/custom-conversion-goals

Access: readZernio: GET /v1/ads/conversions/custom-goals

Try it with MCPAsk your agent to call list-custom-conversion-goals (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Returns object

objectstring

list

dataarray of object
Show 6 item attributes
objectstringrequired

custom_conversion_goal

idstring
resource_namestring | null
namestring | null
statusstring | null
conversion_action_idsarray of string
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/custom-conversion-goals
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/custom-conversion-goals" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a custom conversion goal

POST/ads/accounts/{adAccountId}/custom-conversion-goals

Access: writeIdempotency-KeyZernio: POST /v1/ads/conversions/custom-goals

Try it with MCPAsk your agent to call create-custom-conversion-goal (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 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

namestringrequired

1–255 characters

conversion_action_idsarray of stringrequired

1–100 items

Returns object

objectstringrequired

custom_conversion_goal

idstring
resource_namestring | null
namestring | null
statusstring | null
conversion_action_idsarray of string

Responses

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

Update a custom conversion goal

PATCH/ads/accounts/{adAccountId}/custom-conversion-goals/{goalId}

Access: writeZernio: PATCH /v1/ads/conversions/custom-goals/{goalId}

Try it with MCPAsk your agent to call update-custom-conversion-goal (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

goalIdstringrequired

1–256 characters

Body object

namestring

1–255 characters

conversion_action_idsarray of string

1–100 items

Returns object

objectstringrequired

custom_conversion_goal

idstring
resource_namestring | null
namestring | null
statusstring | null
conversion_action_idsarray of string

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/accounts/{adAccountId}/custom-conversion-goals/{goalId}
curl -X PATCH "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/custom-conversion-goals/GOAL_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "conversion_action_ids": [
      "string"
    ]
  }'
Response · 200

Remove a custom conversion goal

DELETE/ads/accounts/{adAccountId}/custom-conversion-goals/{goalId}

Access: writeZernio: DELETE /v1/ads/conversions/custom-goals/{goalId}

Try it with MCPAsk your agent to call delete-custom-conversion-goal (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

goalIdstringrequired

1–256 characters

Returns object

objectstringrequired

custom_conversion_goal

idstringrequired
deletedbooleanrequired

Responses

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

List conversion destinations

GET/ads/accounts/{adAccountId}/conversion-destinations

Where the ad account can receive conversion events (pixels, conversion actions, conversion rules, …): use id as destination_id.

Access: readZernio: GET /v1/accounts/{accountId}/conversion-destinations

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

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

Query parameters

include_inactiveboolean

Returns object

objectstring

list

dataarray of object
Show 14 item attributes
objectstringrequired

conversion_destination

idstring
namestring | null
typestring | null
statusstring
platformstring
ad_account_idstring | null
conversion_eventsarray of object
Show 6 item attributes
idstring
namestring | null
event_typestring | null
custom_event_namestring | null
archivedboolean
optimizableboolean
attribution_typestring | null
post_click_attribution_window_sizenumber | null
view_through_attribution_window_sizenumber | null
value_typestring | null
valueobject | null
Show 2 child attributes
currency_codestring | null
amountstring | null
enabledboolean | null
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/conversion-destinations
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/conversion-destinations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a conversion destination

POST/ads/accounts/{adAccountId}/conversion-destinations

LinkedIn conversion rule (not idempotent) or Google Ads conversion action (reused by name).

Access: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/conversion-destinations

Try it with MCPAsk your agent to call create-conversion-destination (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 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

namestringrequired

1–255 characters

attribution_typestring

LAST_TOUCH_BY_CAMPAIGNLAST_TOUCH_BY_CONVERSION

post_click_attribution_window_sizeinteger

173090365

view_through_attribution_window_sizeinteger

173090365

value_typestring

DYNAMICFIXEDNO_VALUE

valueobject
Show 2 child attributes
currency_codestringrequired

pattern ^[A-Za-z]{3}$

amountstring | numberrequired
typestringrequired

1–64 characters

auto_association_typestring

ALL_CAMPAIGNSOBJECTIVE_BASEDNONE

counting_typestring

MANY_PER_CLICKONE_PER_CLICK

primary_for_goalboolean

Returns object

objectstringrequired

conversion_destination

idstring
namestring | null
typestring | null
statusstring
platformstring
ad_account_idstring | null
conversion_eventsarray of object
Show 6 item attributes
idstring
namestring | null
event_typestring | null
custom_event_namestring | null
archivedboolean
optimizableboolean
attribution_typestring | null
post_click_attribution_window_sizenumber | null
view_through_attribution_window_sizenumber | null
value_typestring | null
valueobject | null
Show 2 child attributes
currency_codestring | null
amountstring | null
enabledboolean | null

Responses

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

Get a conversion destination

GET/ads/accounts/{adAccountId}/conversion-destinations/{destinationId}

Access: readZernio: GET /v1/accounts/{accountId}/conversion-destinations/{destinationId}

Try it with MCPAsk your agent to call get-conversion-destination (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

destinationIdstringrequired

1–256 characters

Returns object

objectstringrequired

conversion_destination

idstring
namestring | null
typestring | null
statusstring
platformstring
ad_account_idstring | null
conversion_eventsarray of object
Show 6 item attributes
idstring
namestring | null
event_typestring | null
custom_event_namestring | null
archivedboolean
optimizableboolean
attribution_typestring | null
post_click_attribution_window_sizenumber | null
view_through_attribution_window_sizenumber | null
value_typestring | null
valueobject | null
Show 2 child attributes
currency_codestring | null
amountstring | null
enabledboolean | null

Responses

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

Update a conversion destination

PATCH/ads/accounts/{adAccountId}/conversion-destinations/{destinationId}

Access: writeZernio: PATCH /v1/accounts/{accountId}/conversion-destinations/{destinationId}

Try it with MCPAsk your agent to call update-conversion-destination (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

destinationIdstringrequired

1–256 characters

Body object

namestring

1–255 characters

attribution_typestring

LAST_TOUCH_BY_CAMPAIGNLAST_TOUCH_BY_CONVERSION

post_click_attribution_window_sizeinteger

173090365

view_through_attribution_window_sizeinteger

173090365

value_typestring

DYNAMICFIXEDNO_VALUE

valueobject
Show 2 child attributes
currency_codestringrequired

pattern ^[A-Za-z]{3}$

amountstring | numberrequired
enabledboolean

Returns object

objectstringrequired

conversion_destination

idstring
namestring | null
typestring | null
statusstring
platformstring
ad_account_idstring | null
conversion_eventsarray of object
Show 6 item attributes
idstring
namestring | null
event_typestring | null
custom_event_namestring | null
archivedboolean
optimizableboolean
attribution_typestring | null
post_click_attribution_window_sizenumber | null
view_through_attribution_window_sizenumber | null
value_typestring | null
valueobject | null
Show 2 child attributes
currency_codestring | null
amountstring | null
enabledboolean | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/accounts/{adAccountId}/conversion-destinations/{destinationId}
curl -X PATCH "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/conversion-destinations/DESTINATION_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "attribution_type": "LAST_TOUCH_BY_CAMPAIGN",
    "post_click_attribution_window_size": 1,
    "view_through_attribution_window_size": 1,
    "value_type": "DYNAMIC"
  }'
Response · 200

Delete (disable) a conversion destination

DELETE/ads/accounts/{adAccountId}/conversion-destinations/{destinationId}

Access: writeZernio: DELETE /v1/accounts/{accountId}/conversion-destinations/{destinationId}

Try it with MCPAsk your agent to call delete-conversion-destination (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

destinationIdstringrequired

1–256 characters

Returns object

objectstring

conversion_destination

idstring
deletedboolean
statestring

Responses

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

List associated campaigns

GET/ads/accounts/{adAccountId}/conversion-destinations/{destinationId}/associations

Access: readZernio: GET /v1/accounts/{accountId}/conversion-destinations/{destinationId}/associations

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

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

destinationIdstringrequired

1–256 characters

Returns object

objectstring

list

dataarray of object
Show 4 item attributes
objectstringrequired

conversion_association

campaign_idstring
conversion_idstring
associated_atstring (date-time) | null
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/accounts/{adAccountId}/conversion-destinations/{destinationId}/associations
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/conversion-destinations/DESTINATION_ID/associations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Associate campaigns

POST/ads/accounts/{adAccountId}/conversion-destinations/{destinationId}/associations

Access: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/conversion-destinations/{destinationId}/associations

Try it with MCPAsk your agent to call add-conversion-associations (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

destinationIdstringrequired

1–256 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

campaign_idsarray of stringrequired

1–500 items

Returns object

objectstringrequired

conversion_association_result

succeededarray of string
failedarray of object
Show 2 item attributes
campaign_idstring
reasonstring

Responses

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

Remove associated campaigns

DELETE/ads/accounts/{adAccountId}/conversion-destinations/{destinationId}/associations

Access: writeZernio: DELETE /v1/accounts/{accountId}/conversion-destinations/{destinationId}/associations

Try it with MCPAsk your agent to call remove-conversion-associations (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

destinationIdstringrequired

1–256 characters

Query parameters

campaign_idsstringrequired

Comma separated ids

≤ 10000 characters

Returns object

objectstringrequired

conversion_association_result

succeededarray of string
failedarray of object
Show 2 item attributes
campaign_idstring
reasonstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/ads/accounts/{adAccountId}/conversion-destinations/{destinationId}/associations
curl -X DELETE "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/conversion-destinations/DESTINATION_ID/associations?campaign_ids=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Get attribution metrics

GET/ads/accounts/{adAccountId}/conversion-destinations/{destinationId}/metrics

Access: readZernio: GET /v1/accounts/{accountId}/conversion-destinations/{destinationId}/metrics

Try it with MCPAsk your agent to call get-conversion-metrics (toolset ads_measurement)Set up MCP

Path parameters

adAccountIdstringrequired

Ad account id (ada_…)

1–80 characters

destinationIdstringrequired

1–256 characters

Query parameters

start_datestringrequired

YYYY-MM-DD

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

end_datestring

YYYY-MM-DD

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

granularitystring

ALLDAILYMONTHLYYEARLY

Returns object

objectstringrequired

conversion_metrics

destination_idstring
granularitystring
rowsarray of object
Show 3 item attributes
startstring | null
endstring | null
metricsobject
Show 6 child attributes
external_website_conversionsnumber
external_website_post_click_conversionsnumber
external_website_post_view_conversionsnumber
conversion_value_in_local_currencynumber
qualified_leadsnumber
cost_in_local_currencynumber

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/ads/accounts/{adAccountId}/conversion-destinations/{destinationId}/metrics
curl "https://api.socialit.com/v1/ads/accounts/ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/conversion-destinations/DESTINATION_ID/metrics?start_date=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Comments

List comments on an ad

GET/ads/{adId}/comments

Comments on the ad’s post, dark posts included (Meta: Facebook or Instagram placement; TikTok).

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

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

Path parameters

adIdstringrequired

1–256 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

placementstring

facebookinstagram

sincestring

YYYY-MM-DD

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

untilstring

YYYY-MM-DD

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

limitintegerdefault: 25

Items per page (max 100)

1–100

cursorstring

next_cursor from the previous page

≤ 4096 characters

afterstring

Alias of cursor

≤ 4096 characters

Returns object

objectstring

list

dataarray of object
Show 15 item attributes
objectstringrequired

ad_comment

idstring
ad_idstring
platformstring
placementstring | null
parent_idstring | null
textstring
authorobject
Show 3 child attributes
idstring | null
namestring | null
usernamestring | null
like_countinteger
reply_countinteger
hiddenboolean
can_replyboolean
can_hideboolean
can_deleteboolean
created_atstring (date-time) | null
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/{adId}/comments
curl "https://api.socialit.com/v1/ads/AD_ID/comments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Reply to an ad comment

POST/ads/{adId}/comments/{commentId}/reply

Access: writeIdempotency-KeyZernio: POST /v1/ads/{adId}/comments/{commentId}/reply

Try it with MCPAsk your agent to call reply-ad-comment (toolset ads_measurement)Set up MCP

Path parameters

adIdstringrequired

1–256 characters

commentIdstringrequired

1–256 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 has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

textstringrequired

1–500 characters

placementstring

facebookinstagram

Returns object

objectstringrequired

ad_comment

idstring
ad_idstring
platformstring
placementstring | null
parent_idstring | null
textstring
authorobject
Show 3 child attributes
idstring | null
namestring | null
usernamestring | null
like_countinteger
reply_countinteger
hiddenboolean
can_replyboolean
can_hideboolean
can_deleteboolean
created_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/{adId}/comments/{commentId}/reply
curl -X POST "https://api.socialit.com/v1/ads/AD_ID/comments/COMMENT_ID/reply" \
  -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",
    "text": "string",
    "placement": "facebook"
  }'
Response · 201

Hide or unhide an ad comment

POST/ads/{adId}/comments/{commentId}/hide

Access: writeIdempotency-KeyZernio: POST /v1/ads/{adId}/comments/{commentId}/hide

Try it with MCPAsk your agent to call hide-ad-comment (toolset ads_measurement)Set up MCP

Path parameters

adIdstringrequired

1–256 characters

commentIdstringrequired

1–256 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 has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

hiddenbooleanrequired
placementstring

facebookinstagram

Returns object

objectstringrequired

ad_comment

idstring
hiddenboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/{adId}/comments/{commentId}/hide
curl -X POST "https://api.socialit.com/v1/ads/AD_ID/comments/COMMENT_ID/hide" \
  -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",
    "hidden": true,
    "placement": "facebook"
  }'
Response · 200

Delete an ad comment

DELETE/ads/{adId}/comments/{commentId}

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

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

Path parameters

adIdstringrequired

1–256 characters

commentIdstringrequired

1–256 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

placementstring

facebookinstagram

Returns object

objectstringrequired

ad_comment

idstringrequired
deletedbooleanrequired

Responses

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

Tracking tags

Get ad URL tracking params

GET/ads/{adId}/tracking-tags

Click-URL tracking parameters (UTMs), not pixels: Meta creative url_tags, Google campaign tracking template / final URL suffix, LinkedIn Dynamic UTMs.

Access: readZernio: GET /v1/ads/{adId}/tracking-tags

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

Path parameters

adIdstringrequired

1–256 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

campaign_idstring

1–64 characters

Returns object

objectstringrequired

ad_tracking_params

ad_idstring
platformstring
levelstring
url_tagsstring | null
template_url_specobject | null
tracking_url_templatestring | null
final_url_suffixstring | null
dynamic_value_parametersobject | null
custom_value_parametersobject | null

Responses

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

Set ad URL tracking params

PATCH/ads/{adId}/tracking-tags

Meta rebuilds the (immutable) creative with the new url_tags and repoints the ad.

Access: writeZernio: PATCH /v1/ads/{adId}/tracking-tags

Try it with MCPAsk your agent to call set-ad-tracking-params (toolset ads_measurement)Set up MCP

Path parameters

adIdstringrequired

1–256 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

campaign_idstring

1–64 characters

url_tagsarray of object

≤ 50 items

Show 2 item attributes
keystringrequired

1–100 characters

valuestringrequired

≤ 500 characters

creativeobject
Show 7 child attributes
headlinestringrequired

1–255 characters

bodystringrequired

≤ 5000 characters

call_to_actionstringrequired

1–64 characters

link_urlstring (uri)required

≤ 2048 characters

image_urlstring (uri)

≤ 2048 characters

video_urlstring (uri)

≤ 2048 characters

video_idstring

1–64 characters

tracking_url_templatestring

≤ 2048 characters

final_url_suffixstring

≤ 2048 characters

dynamic_value_parametersmap of string
custom_value_parametersmap of string

Returns object

objectstringrequired

ad_tracking_params

ad_idstring
platformstring
levelstring
url_tagsstring | null
template_url_specobject | null
tracking_url_templatestring | null
final_url_suffixstring | null
dynamic_value_parametersobject | null
custom_value_parametersobject | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/{adId}/tracking-tags
curl -X PATCH "https://api.socialit.com/v1/ads/AD_ID/tracking-tags" \
  -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",
    "campaign_id": "string",
    "url_tags": [
      {
        "key": "string",
        "value": "string"
      }
    ]
  }'
Response · 200

Leads

List leads

GET/ads/leads

Stored lead-gen submissions (leadgen webhooks, live form reads, LinkedIn polling).

Access: readZernio: GET /v1/ads/leads

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

Query parameters

pageintegerdefault: 1

≥ 1

limitintegerdefault: 20

1–100

ad_account_idstring

1–80 characters

connection_idstring

1–80 characters

form_idstring

1–64 characters

platformstring

1–40 characters

ad_idstring

1–64 characters

campaign_idstring

1–64 characters

is_testboolean
is_organicboolean
sourcestring

webhooksyncapi

sincestring

1–40 characters

untilstring

1–40 characters

sortstring

submitted_atcreated_at

orderstring

ascdesc

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 22 item attributes
objectstringrequired

lead

idstring
external_idstring
platformstring
connection_idstring | null
ad_account_idstring | null
profile_idstring | null
contact_idstring | null
form_idstring | null
form_namestring | null
page_idstring | null
ad_idstring | null
ad_set_idstring | null
campaign_idstring | null
is_organicboolean
is_testboolean
fieldsmap of string
field_dataarray of object
Show 2 item attributes
namestring
valuesarray of string
sourcestring
submitted_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/leads
curl "https://api.socialit.com/v1/ads/leads" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Get a lead

GET/ads/leads/{leadId}

Access: read

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

Path parameters

leadIdstringrequired

1–80 characters

Returns object

objectstringrequired

lead

idstring
external_idstring
platformstring
connection_idstring | null
ad_account_idstring | null
profile_idstring | null
contact_idstring | null
form_idstring | null
form_namestring | null
page_idstring | null
ad_idstring | null
ad_set_idstring | null
campaign_idstring | null
is_organicboolean
is_testboolean
fieldsmap of string
field_dataarray of object
Show 2 item attributes
namestring
valuesarray of string
sourcestring
submitted_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/leads/{leadId}
curl "https://api.socialit.com/v1/ads/leads/LEAD_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Lead forms

List lead forms

GET/ads/lead-forms

Meta instant forms of a Page, LinkedIn Lead Gen Forms of a sponsored account.

Access: readZernio: GET /v1/ads/lead-forms

Try it with MCPAsk your agent to call list-lead-forms (toolset ads_measurement)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 has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

page_idstring

1–64 characters

statusstring

1–32 characters

limitintegerdefault: 25

Items per page (max 100)

1–100

cursorstring

next_cursor from the previous page

≤ 4096 characters

afterstring

Alias of cursor

≤ 4096 characters

Returns object

objectstring

list

dataarray of object
Show 17 item attributes
objectstringrequired

lead_form

idstring
platformstring
namestring | null
statusstring | null
localestring | null
page_idstring | null
ad_account_idstring | null
leads_countinteger | null
privacy_policy_urlstring | null
follow_up_action_urlstring | null
headlinestring | null
descriptionstring | null
questionsarray of object
Show 5 item attributes
idstring | null
keystring | null
labelstring | null
typestring | null
optionsarray of object
Show 2 item attributes
valuestring | null
keystring | null
thank_you_pageobject | null
Show 5 child attributes
titlestring | null
bodystring | null
button_textstring | null
button_typestring | null
website_urlstring | null
created_atstring (date-time) | null
rawobject
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/lead-forms
curl "https://api.socialit.com/v1/ads/lead-forms" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a lead form

POST/ads/lead-forms

Access: writeIdempotency-KeyZernio: POST /v1/ads/lead-forms

Try it with MCPAsk your agent to call create-lead-form (toolset ads_measurement)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 has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

namestringrequired

1–255 characters

page_idstring

1–64 characters

questionsarray of objectrequired

1–30 items

Show 5 item attributes
typestringrequired

1–64 characters

keystring

1–100 characters

labelstring

1–500 characters

inline_contextstring

1–500 characters

optionsarray of object

≤ 50 items

Show 2 item attributes
valuestringrequired

1–200 characters

keystring

1–100 characters

privacy_policy_urlstring (uri)required

≤ 2048 characters

privacy_policy_link_textstring

1–70 characters

follow_up_action_urlstring (uri)

≤ 2048 characters

localestring

pattern ^[a-z]{2}_[A-Z]{2}$

thank_you_titlestring

1–60 characters

thank_you_bodystring

1–500 characters

thank_you_button_textstring

1–60 characters

thank_you_button_typestring

1–64 characters

thank_you_website_urlstring (uri)

≤ 2048 characters

is_optimized_for_qualityboolean
headlinestring

1–60 characters

descriptionstring

1–160 characters

statestring

DRAFTPUBLISHED

platform_dataobject

Returns object

objectstringrequired

lead_form

idstring
platformstring
namestring | null
statusstring | null
localestring | null
page_idstring | null
ad_account_idstring | null
leads_countinteger | null
privacy_policy_urlstring | null
follow_up_action_urlstring | null
headlinestring | null
descriptionstring | null
questionsarray of object
Show 5 item attributes
idstring | null
keystring | null
labelstring | null
typestring | null
optionsarray of object
Show 2 item attributes
valuestring | null
keystring | null
thank_you_pageobject | null
Show 5 child attributes
titlestring | null
bodystring | null
button_textstring | null
button_typestring | null
website_urlstring | null
created_atstring (date-time) | null
rawobject

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/lead-forms
curl -X POST "https://api.socialit.com/v1/ads/lead-forms" \
  -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",
    "name": "string",
    "questions": [
      {
        "type": "string",
        "key": "string"
      }
    ],
    "privacy_policy_url": "https://example.com"
  }'
Response · 201

Get a lead form

GET/ads/lead-forms/{formId}

Access: readZernio: GET /v1/ads/lead-forms/{formId}

Try it with MCPAsk your agent to call get-lead-form (toolset ads_measurement)Set up MCP

Path parameters

formIdstringrequired

1–256 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

page_idstring

1–64 characters

Returns object

objectstringrequired

lead_form

idstring
platformstring
namestring | null
statusstring | null
localestring | null
page_idstring | null
ad_account_idstring | null
leads_countinteger | null
privacy_policy_urlstring | null
follow_up_action_urlstring | null
headlinestring | null
descriptionstring | null
questionsarray of object
Show 5 item attributes
idstring | null
keystring | null
labelstring | null
typestring | null
optionsarray of object
Show 2 item attributes
valuestring | null
keystring | null
thank_you_pageobject | null
Show 5 child attributes
titlestring | null
bodystring | null
button_textstring | null
button_typestring | null
website_urlstring | null
created_atstring (date-time) | null
rawobject

Responses

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

Archive a lead form

DELETE/ads/lead-forms/{formId}

Access: writeZernio: DELETE /v1/ads/lead-forms/{formId}

Try it with MCPAsk your agent to call archive-lead-form (toolset ads_measurement)Set up MCP

Path parameters

formIdstringrequired

1–256 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

page_idstring

1–64 characters

Returns object

objectstring

lead_form

idstring
archivedboolean
deletedboolean

Responses

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

List the leads of a form

GET/ads/lead-forms/{formId}/leads

Reads the form’s leads live and stores them (new leads emit lead.received).

Access: readZernio: GET /v1/ads/lead-forms/{formId}/leads

Try it with MCPAsk your agent to call list-lead-form-leads (toolset ads_measurement)Set up MCP

Path parameters

formIdstringrequired

1–256 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

page_idstring

1–64 characters

sincestring | integer

ISO 8601 date-time or unix seconds

limitintegerdefault: 25

Items per page (max 100)

1–100

cursorstring

next_cursor from the previous page

≤ 4096 characters

afterstring

Alias of cursor

≤ 4096 characters

Returns object

objectstring

list

dataarray of object
Show 22 item attributes
objectstringrequired

lead

idstring
external_idstring
platformstring
connection_idstring | null
ad_account_idstring | null
profile_idstring | null
contact_idstring | null
form_idstring | null
form_namestring | null
page_idstring | null
ad_idstring | null
ad_set_idstring | null
campaign_idstring | null
is_organicboolean
is_testboolean
fieldsmap of string
field_dataarray of object
Show 2 item attributes
namestring
valuesarray of string
sourcestring
submitted_atstring (date-time) | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/lead-forms/{formId}/leads
curl "https://api.socialit.com/v1/ads/lead-forms/FORM_ID/leads" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a test lead

POST/ads/lead-forms/{formId}/test-leads

Access: writeIdempotency-KeyZernio: POST /v1/ads/lead-forms/{formId}/test-leads

Try it with MCPAsk your agent to call create-test-lead (toolset ads_measurement)Set up MCP

Path parameters

formIdstringrequired

1–256 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 has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

page_idstring

1–64 characters

field_dataarray of objectrequired

1–50 items

Show 2 item attributes
namestringrequired

1–100 characters

valuesarray of stringrequired

≥ 1 items

Returns object

objectstringrequired

test_lead

idstring
form_idstring

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/lead-forms/{formId}/test-leads
curl -X POST "https://api.socialit.com/v1/ads/lead-forms/FORM_ID/test-leads" \
  -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",
    "page_id": "string",
    "field_data": [
      {
        "name": "string",
        "values": [
          "string"
        ]
      }
    ]
  }'
Response · 201

Delete test leads

DELETE/ads/lead-forms/{formId}/test-leads

Access: writeZernio: DELETE /v1/ads/lead-forms/{formId}/test-leads

Try it with MCPAsk your agent to call delete-test-leads (toolset ads_measurement)Set up MCP

Path parameters

formIdstringrequired

1–256 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

page_idstring

1–64 characters

lead_idstring

1–64 characters

Returns object

objectstring

test_lead

deletedboolean
idsarray of string

Responses

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

Catalogs

List product catalogs

GET/ads/catalogs

Meta Commerce catalogs owned by (or shared with) a business portfolio.

Access: readZernio: GET /v1/ads/catalogs

Try it with MCPAsk your agent to call list-catalogs (toolset ads_measurement)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 has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

business_idstring

1–64 characters

limitintegerdefault: 25

Items per page (max 100)

1–100

cursorstring

next_cursor from the previous page

≤ 4096 characters

afterstring

Alias of cursor

≤ 4096 characters

Returns object

objectstring

list

dataarray of object
Show 6 item attributes
objectstringrequired

catalog

idstring
namestring | null
verticalstring | null
product_countinteger | null
business_idstring | null
pageinteger
limitinteger
totalinteger | null
has_moreboolean
next_page_urlstring | null
previous_page_urlstring | null
next_cursorstring | null
business_idstring | null

Responses

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

Create a product catalog

POST/ads/catalogs

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

Try it with MCPAsk your agent to call create-catalog (toolset ads_measurement)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 has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

business_idstring

1–64 characters

namestringrequired

1–200 characters

verticalstring

commercevehicleshotelsflightsdestinationshome_listingslocal_service_businessoffline_commerceticketed_experiencestransactable_items

Returns object

objectstringrequired

catalog

idstring
namestring | null
verticalstring | null
product_countinteger | null
business_idstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/catalogs
curl -X POST "https://api.socialit.com/v1/ads/catalogs" \
  -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",
    "business_id": "string",
    "name": "string"
  }'
Response · 201

Get a product catalog

GET/ads/catalogs/{catalogId}

Access: readZernio: GET /v1/ads/catalogs/{catalogId}

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

Path parameters

catalogIdstringrequired

1–256 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

business_idstring

1–64 characters

limitintegerdefault: 25

Items per page (max 100)

1–100

cursorstring

next_cursor from the previous page

≤ 4096 characters

afterstring

Alias of cursor

≤ 4096 characters

Returns object

objectstringrequired

catalog

idstring
namestring | null
verticalstring | null
product_countinteger | null
business_idstring | null

Responses

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

Delete a product catalog

DELETE/ads/catalogs/{catalogId}

Access: writeZernio: DELETE /v1/ads/catalogs/{catalogId}

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

Path parameters

catalogIdstringrequired

1–256 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

business_idstring

1–64 characters

limitintegerdefault: 25

Items per page (max 100)

1–100

cursorstring

next_cursor from the previous page

≤ 4096 characters

afterstring

Alias of cursor

≤ 4096 characters

Returns object

objectstringrequired

catalog

idstringrequired
deletedbooleanrequired

Responses

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

List catalog products

GET/ads/catalogs/{catalogId}/products

Access: readZernio: GET /v1/ads/catalogs/{catalogId}/products

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

Path parameters

catalogIdstringrequired

1–256 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

retailer_idstring

1–100 characters

limitintegerdefault: 25

Items per page (max 100)

1–100

cursorstring

next_cursor from the previous page

≤ 4096 characters

afterstring

Alias of cursor

≤ 4096 characters

Returns object

objectstring

list

dataarray of object
Show 27 item attributes
objectstringrequired

catalog_product

idstring
retailer_idstring | null
namestring | null
descriptionstring | null
urlstring | null
image_urlstring | null
additional_image_urlsarray of string
pricestring | null
sale_pricestring | null
currencystring | null
availabilitystring | null
conditionstring | null
brandstring | null
categorystring | null
product_typestring | null
gtinstring | null
inventoryinteger | null
visibilitystring | null
colorstring | null
sizestring | null
genderstring | null
materialstring | null
patternstring | null
custom_labelsarray of string | null
review_statusstring | null
review_rejection_reasonsarray of string
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/catalogs/{catalogId}/products
curl "https://api.socialit.com/v1/ads/catalogs/CATALOG_ID/products" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Add a product

POST/ads/catalogs/{catalogId}/products

Access: writeIdempotency-KeyZernio: POST /v1/ads/catalogs/{catalogId}/products

Try it with MCPAsk your agent to call create-catalog-product (toolset ads_measurement)Set up MCP

Path parameters

catalogIdstringrequired

1–256 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 has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

productobjectrequired
Show 31 child attributes
retailer_idstring

1–100 characters

namestring

1–200 characters

descriptionstring

1–9999 characters

urlstring (uri)

≤ 2048 characters

image_urlstring (uri)

≤ 2048 characters

additional_image_urlsarray of string (uri)

≤ 20 items

pricenumber
currencystring

pattern ^[A-Za-z]{3}$

sale_pricenumber
sale_price_start_datestring

1–40 characters

sale_price_end_datestring

1–40 characters

availabilitystring

in stockout of stockpreorderavailable for orderdiscontinuedpending

conditionstring

newrefurbishedused

brandstring

1–100 characters

categorystring

1–250 characters

google_product_categorystring

1–250 characters

product_typestring

1–750 characters

gtinstring

1–70 characters

mpnstring

1–100 characters

inventoryinteger
visibilitystring

publishedstaging

colorstring

1–200 characters

sizestring

1–200 characters

genderstring

femalemaleunisex

materialstring

1–200 characters

patternstring

1–100 characters

custom_label_0string

1–100 characters

custom_label_1string

1–100 characters

custom_label_2string

1–100 characters

custom_label_3string

1–100 characters

custom_label_4string

1–100 characters

Returns object

objectstringrequired

catalog_product

idstring
retailer_idstring | null
namestring | null
descriptionstring | null
urlstring | null
image_urlstring | null
additional_image_urlsarray of string
pricestring | null
sale_pricestring | null
currencystring | null
availabilitystring | null
conditionstring | null
brandstring | null
categorystring | null
product_typestring | null
gtinstring | null
inventoryinteger | null
visibilitystring | null
colorstring | null
sizestring | null
genderstring | null
materialstring | null
patternstring | null
custom_labelsarray of string | null
review_statusstring | null
review_rejection_reasonsarray of string

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/catalogs/{catalogId}/products
curl -X POST "https://api.socialit.com/v1/ads/catalogs/CATALOG_ID/products" \
  -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",
    "product": {
      "retailer_id": "string",
      "name": "string"
    }
  }'
Response · 201

Create, update or delete products in bulk

POST/ads/catalogs/{catalogId}/products/batch

Up to 5,000 requests keyed by retailer_id, processed asynchronously (202).

Access: writeIdempotency-KeyZernio: POST /v1/ads/catalogs/{catalogId}/products/batch

Try it with MCPAsk your agent to call batch-catalog-products (toolset ads_measurement)Set up MCP

Path parameters

catalogIdstringrequired

1–256 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 has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

requestsarray of objectrequired

1–5000 items

Show 2 item attributes
methodstringrequired

CREATEUPDATEDELETE

productobjectrequired
Show 31 child attributes
retailer_idstring

1–100 characters

namestring

1–200 characters

descriptionstring

1–9999 characters

urlstring (uri)

≤ 2048 characters

image_urlstring (uri)

≤ 2048 characters

additional_image_urlsarray of string (uri)

≤ 20 items

pricenumber
currencystring

pattern ^[A-Za-z]{3}$

sale_pricenumber
sale_price_start_datestring

1–40 characters

sale_price_end_datestring

1–40 characters

availabilitystring

in stockout of stockpreorderavailable for orderdiscontinuedpending

conditionstring

newrefurbishedused

brandstring

1–100 characters

categorystring

1–250 characters

google_product_categorystring

1–250 characters

product_typestring

1–750 characters

gtinstring

1–70 characters

mpnstring

1–100 characters

inventoryinteger
visibilitystring

publishedstaging

colorstring

1–200 characters

sizestring

1–200 characters

genderstring

femalemaleunisex

materialstring

1–200 characters

patternstring

1–100 characters

custom_label_0string

1–100 characters

custom_label_1string

1–100 characters

custom_label_2string

1–100 characters

custom_label_3string

1–100 characters

custom_label_4string

1–100 characters

Returns object

objectstringrequired

catalog_batch_request

catalog_idstring
handlesarray of string
status_urlstring | null

Responses

  • 202Accepted
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/catalogs/{catalogId}/products/batch
curl -X POST "https://api.socialit.com/v1/ads/catalogs/CATALOG_ID/products/batch" \
  -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",
    "requests": [
      {
        "method": "CREATE",
        "product": {
          "retailer_id": "string",
          "name": "string"
        }
      }
    ]
  }'
Response · 202

Get a bulk request’s status

GET/ads/catalogs/{catalogId}/batches/{handle}

Access: readZernio: GET /v1/ads/catalogs/{catalogId}/batches/{handle}

Try it with MCPAsk your agent to call get-catalog-batch (toolset ads_measurement)Set up MCP

Path parameters

catalogIdstringrequired

1–256 characters

handlestringrequired

1–256 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

business_idstring

1–64 characters

limitintegerdefault: 25

Items per page (max 100)

1–100

cursorstring

next_cursor from the previous page

≤ 4096 characters

afterstring

Alias of cursor

≤ 4096 characters

Returns object

objectstringrequired

catalog_batch

handlestring
statusstring
errors_total_countinteger
errorsarray of object
Show 2 item attributes
retailer_idstring | null
messagestring

Responses

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

Get a product

GET/ads/catalogs/{catalogId}/products/{productId}

Access: readZernio: GET /v1/ads/catalogs/{catalogId}/products/{productId}

Try it with MCPAsk your agent to call get-catalog-product (toolset ads_measurement)Set up MCP

Path parameters

catalogIdstringrequired

1–256 characters

productIdstringrequired

1–256 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

business_idstring

1–64 characters

limitintegerdefault: 25

Items per page (max 100)

1–100

cursorstring

next_cursor from the previous page

≤ 4096 characters

afterstring

Alias of cursor

≤ 4096 characters

Returns object

objectstringrequired

catalog_product

idstring
retailer_idstring | null
namestring | null
descriptionstring | null
urlstring | null
image_urlstring | null
additional_image_urlsarray of string
pricestring | null
sale_pricestring | null
currencystring | null
availabilitystring | null
conditionstring | null
brandstring | null
categorystring | null
product_typestring | null
gtinstring | null
inventoryinteger | null
visibilitystring | null
colorstring | null
sizestring | null
genderstring | null
materialstring | null
patternstring | null
custom_labelsarray of string | null
review_statusstring | null
review_rejection_reasonsarray of string

Responses

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

Update a product

PATCH/ads/catalogs/{catalogId}/products/{productId}

Access: writeZernio: PUT /v1/ads/catalogs/{catalogId}/products/{productId}

Try it with MCPAsk your agent to call update-catalog-product (toolset ads_measurement)Set up MCP

Path parameters

catalogIdstringrequired

1–256 characters

productIdstringrequired

1–256 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

productobjectrequired
Show 31 child attributes
retailer_idstring

1–100 characters

namestring

1–200 characters

descriptionstring

1–9999 characters

urlstring (uri)

≤ 2048 characters

image_urlstring (uri)

≤ 2048 characters

additional_image_urlsarray of string (uri)

≤ 20 items

pricenumber
currencystring

pattern ^[A-Za-z]{3}$

sale_pricenumber
sale_price_start_datestring

1–40 characters

sale_price_end_datestring

1–40 characters

availabilitystring

in stockout of stockpreorderavailable for orderdiscontinuedpending

conditionstring

newrefurbishedused

brandstring

1–100 characters

categorystring

1–250 characters

google_product_categorystring

1–250 characters

product_typestring

1–750 characters

gtinstring

1–70 characters

mpnstring

1–100 characters

inventoryinteger
visibilitystring

publishedstaging

colorstring

1–200 characters

sizestring

1–200 characters

genderstring

femalemaleunisex

materialstring

1–200 characters

patternstring

1–100 characters

custom_label_0string

1–100 characters

custom_label_1string

1–100 characters

custom_label_2string

1–100 characters

custom_label_3string

1–100 characters

custom_label_4string

1–100 characters

Returns object

objectstringrequired

catalog_product

idstring
retailer_idstring | null
namestring | null
descriptionstring | null
urlstring | null
image_urlstring | null
additional_image_urlsarray of string
pricestring | null
sale_pricestring | null
currencystring | null
availabilitystring | null
conditionstring | null
brandstring | null
categorystring | null
product_typestring | null
gtinstring | null
inventoryinteger | null
visibilitystring | null
colorstring | null
sizestring | null
genderstring | null
materialstring | null
patternstring | null
custom_labelsarray of string | null
review_statusstring | null
review_rejection_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/catalogs/{catalogId}/products/{productId}
curl -X PATCH "https://api.socialit.com/v1/ads/catalogs/CATALOG_ID/products/PRODUCT_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",
    "product": {
      "retailer_id": "string",
      "name": "string"
    }
  }'
Response · 200

Delete a product

DELETE/ads/catalogs/{catalogId}/products/{productId}

Access: writeZernio: DELETE /v1/ads/catalogs/{catalogId}/products/{productId}

Try it with MCPAsk your agent to call delete-catalog-product (toolset ads_measurement)Set up MCP

Path parameters

catalogIdstringrequired

1–256 characters

productIdstringrequired

1–256 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

business_idstring

1–64 characters

limitintegerdefault: 25

Items per page (max 100)

1–100

cursorstring

next_cursor from the previous page

≤ 4096 characters

afterstring

Alias of cursor

≤ 4096 characters

Returns object

objectstringrequired

catalog_product

idstringrequired
deletedbooleanrequired

Responses

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

List product feeds

GET/ads/catalogs/{catalogId}/feeds

Access: readZernio: GET /v1/ads/catalogs/{catalogId}/feeds

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

Path parameters

catalogIdstringrequired

1–256 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

business_idstring

1–64 characters

limitintegerdefault: 25

Items per page (max 100)

1–100

cursorstring

next_cursor from the previous page

≤ 4096 characters

afterstring

Alias of cursor

≤ 4096 characters

Returns object

objectstring

list

dataarray of object
Show 7 item attributes
objectstringrequired

catalog_feed

idstring
namestring | null
product_countinteger | null
scheduleobject | null
Show 4 child attributes
intervalstring | null
urlstring | null
hourinteger | null
day_of_weekstring | null
created_atstring (date-time) | null
latest_uploadobject | null
Show 9 child attributes
objectstring

catalog_feed_upload

idstring
urlstring | null
start_timestring (date-time) | null
end_timestring (date-time) | null
error_countinteger | null
warning_countinteger | null
items_detectedinteger | null
items_deletedinteger | null
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/catalogs/{catalogId}/feeds
curl "https://api.socialit.com/v1/ads/catalogs/CATALOG_ID/feeds" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a product feed

POST/ads/catalogs/{catalogId}/feeds

Access: writeIdempotency-KeyZernio: POST /v1/ads/catalogs/{catalogId}/feeds

Try it with MCPAsk your agent to call create-catalog-feed (toolset ads_measurement)Set up MCP

Path parameters

catalogIdstringrequired

1–256 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 has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

namestringrequired

1–200 characters

scheduleobject
Show 4 child attributes
intervalstringrequired

HOURLYDAILYWEEKLY

urlstring (uri)required

≤ 2048 characters

hourinteger

0–23

day_of_weekstring

SUNDAYMONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAY

Returns object

objectstringrequired

catalog_feed

idstring
namestring | null
product_countinteger | null
scheduleobject | null
Show 4 child attributes
intervalstring | null
urlstring | null
hourinteger | null
day_of_weekstring | null
created_atstring (date-time) | null
latest_uploadobject | null
Show 9 child attributes
objectstring

catalog_feed_upload

idstring
urlstring | null
start_timestring (date-time) | null
end_timestring (date-time) | null
error_countinteger | null
warning_countinteger | null
items_detectedinteger | null
items_deletedinteger | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/catalogs/{catalogId}/feeds
curl -X POST "https://api.socialit.com/v1/ads/catalogs/CATALOG_ID/feeds" \
  -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",
    "schedule": {
      "interval": "HOURLY",
      "url": "https://example.com"
    }
  }'
Response · 201

List a feed’s uploads

GET/ads/catalogs/{catalogId}/feeds/{feedId}/uploads

Access: readZernio: GET /v1/ads/catalogs/{catalogId}/feeds/{feedId}/uploads

Try it with MCPAsk your agent to call list-catalog-feed-uploads (toolset ads_measurement)Set up MCP

Path parameters

catalogIdstringrequired

1–256 characters

feedIdstringrequired

1–256 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

business_idstring

1–64 characters

limitintegerdefault: 25

Items per page (max 100)

1–100

cursorstring

next_cursor from the previous page

≤ 4096 characters

afterstring

Alias of cursor

≤ 4096 characters

Returns object

objectstring

list

dataarray of object
Show 9 item attributes
objectstringrequired

catalog_feed_upload

idstring
urlstring | null
start_timestring (date-time) | null
end_timestring (date-time) | null
error_countinteger | null
warning_countinteger | null
items_detectedinteger | null
items_deletedinteger | null
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/catalogs/{catalogId}/feeds/{feedId}/uploads
curl "https://api.socialit.com/v1/ads/catalogs/CATALOG_ID/feeds/FEED_ID/uploads" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Fetch a feed file now

POST/ads/catalogs/{catalogId}/feeds/{feedId}/uploads

Access: writeIdempotency-KeyZernio: POST /v1/ads/catalogs/{catalogId}/feeds/{feedId}/uploads

Try it with MCPAsk your agent to call create-catalog-feed-upload (toolset ads_measurement)Set up MCP

Path parameters

catalogIdstringrequired

1–256 characters

feedIdstringrequired

1–256 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 has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

urlstring (uri)required

≤ 2048 characters

Returns object

objectstringrequired

catalog_feed_upload

idstring
urlstring | null
start_timestring (date-time) | null
end_timestring (date-time) | null
error_countinteger | null
warning_countinteger | null
items_detectedinteger | null
items_deletedinteger | null

Responses

  • 202Accepted
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/catalogs/{catalogId}/feeds/{feedId}/uploads
curl -X POST "https://api.socialit.com/v1/ads/catalogs/CATALOG_ID/feeds/FEED_ID/uploads" \
  -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",
    "url": "https://example.com"
  }'
Response · 202

List product sets

GET/ads/catalogs/{catalogId}/product-sets

Access: readZernio: GET /v1/ads/catalogs/{catalogId}/product-sets

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

Path parameters

catalogIdstringrequired

1–256 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

business_idstring

1–64 characters

limitintegerdefault: 25

Items per page (max 100)

1–100

cursorstring

next_cursor from the previous page

≤ 4096 characters

afterstring

Alias of cursor

≤ 4096 characters

Returns object

objectstring

list

dataarray of object
Show 5 item attributes
objectstringrequired

product_set

idstring
namestring | null
product_countinteger | null
filterobject | null
pageinteger
limitinteger
totalinteger | null
has_moreboolean
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/catalogs/{catalogId}/product-sets
curl "https://api.socialit.com/v1/ads/catalogs/CATALOG_ID/product-sets" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Create a product set

POST/ads/catalogs/{catalogId}/product-sets

Access: writeIdempotency-KeyZernio: POST /v1/ads/catalogs/{catalogId}/product-sets

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

Path parameters

catalogIdstringrequired

1–256 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 has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

namestringrequired

1–200 characters

filterobjectrequired

Returns object

objectstringrequired

product_set

idstring
namestring | null
product_countinteger | null
filterobject | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/catalogs/{catalogId}/product-sets
curl -X POST "https://api.socialit.com/v1/ads/catalogs/CATALOG_ID/product-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",
    "name": "string",
    "filter": {}
  }'
Response · 201

Update a product set

PATCH/ads/catalogs/{catalogId}/product-sets/{productSetId}

Access: writeZernio: PUT /v1/ads/catalogs/{catalogId}/product-sets/{productSetId}

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

Path parameters

catalogIdstringrequired

1–256 characters

productSetIdstringrequired

1–256 characters

Body object

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

namestring

1–200 characters

filterobject

Returns object

objectstringrequired

product_set

idstring
namestring | null
product_countinteger | null
filterobject | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/ads/catalogs/{catalogId}/product-sets/{productSetId}
curl -X PATCH "https://api.socialit.com/v1/ads/catalogs/CATALOG_ID/product-sets/PRODUCT_SET_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",
    "filter": {}
  }'
Response · 200

Delete a product set

DELETE/ads/catalogs/{catalogId}/product-sets/{productSetId}

Access: writeZernio: DELETE /v1/ads/catalogs/{catalogId}/product-sets/{productSetId}

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

Path parameters

catalogIdstringrequired

1–256 characters

productSetIdstringrequired

1–256 characters

Query parameters

ad_account_idstring

Ad account (ada_…)

≤ 80 characters

connection_idstring

Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

business_idstring

1–64 characters

limitintegerdefault: 25

Items per page (max 100)

1–100

cursorstring

next_cursor from the previous page

≤ 4096 characters

afterstring

Alias of cursor

≤ 4096 characters

Returns object

objectstringrequired

product_set

idstringrequired
deletedbooleanrequired

Responses

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

Conversions

Send conversion events

POST/ads/conversions

Relays server-side conversion events (PII normalized + SHA-256 hashed, never stored) to the network Conversions API.

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

Try it with MCPAsk your agent to call send-conversions (toolset ads_measurement)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 has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

destination_idstringrequired

1–256 characters

eventsarray of objectrequired

1–1000 items

Show 11 item attributes
event_namestringrequired

1–100 characters

event_timestring | integerrequired

ISO 8601 date-time or unix seconds

event_idstringrequired

1–100 characters

valuenumber
currencystring

pattern ^[A-Za-z]{3}$

userobjectrequired
Show 35 child attributes
emailstring

1–320 characters

emailsarray of string

≤ 10 items

phonestring

1–64 characters

phonesarray of string

≤ 10 items

first_namestring

1–200 characters

last_namestring

1–200 characters

citystring

1–200 characters

statestring

1–100 characters

zipstring

1–32 characters

countrystring

1–64 characters

date_of_birthstring

1–16 characters

genderstring

1–16 characters

external_idstring

1–256 characters

external_idsarray of string

≤ 10 items

ip_addressstring

1–64 characters

user_agentstring

1–1024 characters

company_namestring

1–200 characters

titlestring

1–200 characters

fbcstring

1–500 characters

fbpstring

1–500 characters

gclidstring

1–500 characters

gbraidstring

1–500 characters

wbraidstring

1–500 characters

ttclidstring

1–500 characters

ttpstring

1–500 characters

li_fat_idstring

1–500 characters

epikstring

1–500 characters

sc_click_idstring

1–500 characters

sc_cookie1string

1–500 characters

rdt_cidstring

1–500 characters

twclidstring

1–500 characters

click_idstring

1–500 characters

lead_idstring

1–64 characters

uuidstring

1–200 characters

hashedboolean
itemsarray of object

≤ 200 items

Show 5 item attributes
idstringrequired

1–100 characters

quantityinteger

≥ 1

pricenumber
namestring

1–200 characters

categorystring

1–200 characters

source_urlstring (uri)

≤ 2048 characters

action_sourcestring

webappofflinecrmphone_callsystem_generated

order_idstring

1–100 characters

platform_dataobject
test_codestring

1–100 characters

consentobject
Show 2 child attributes
ad_user_datastring

GRANTEDDENIED

ad_personalizationstring

GRANTEDDENIED

Returns object

objectstringrequired

conversion_result

platformstring
ad_account_idstring
destination_idstring
testboolean
events_receivedinteger
events_failedinteger
failuresarray of object
Show 4 item attributes
indexinteger
event_idstring | null
messagestring
codestring | null
trace_idstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/conversions
curl -X POST "https://api.socialit.com/v1/ads/conversions" \
  -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",
    "destination_id": "string",
    "events": [
      {
        "event_name": "string",
        "event_time": "string",
        "event_id": "string",
        "user": {
          "email": "you@example.com",
          "emails": [
            "string"
          ]
        }
      }
    ]
  }'
Response · 200

Adjust uploaded conversions

POST/ads/conversions/adjustments

Retract, restate or enhance conversions already sent (Google Ads).

Access: writeIdempotency-KeyZernio: POST /v1/ads/conversions/adjustments

Try it with MCPAsk your agent to call adjust-conversions (toolset ads_measurement)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 has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

destination_idstringrequired

1–64 characters

adjustmentsarray of objectrequired

1–2000 items

Show 9 item attributes
adjustment_typestringrequired

RETRACTIONRESTATEMENTENHANCEMENT

adjustment_timestring | integerrequired

ISO 8601 date-time or unix seconds

order_idstring

1–100 characters

gclidstring

1–500 characters

conversion_timestring | integer

ISO 8601 date-time or unix seconds

restatement_valuenumber
currencystring

pattern ^[A-Za-z]{3}$

userobject
Show 35 child attributes
emailstring

1–320 characters

emailsarray of string

≤ 10 items

phonestring

1–64 characters

phonesarray of string

≤ 10 items

first_namestring

1–200 characters

last_namestring

1–200 characters

citystring

1–200 characters

statestring

1–100 characters

zipstring

1–32 characters

countrystring

1–64 characters

date_of_birthstring

1–16 characters

genderstring

1–16 characters

external_idstring

1–256 characters

external_idsarray of string

≤ 10 items

ip_addressstring

1–64 characters

user_agentstring

1–1024 characters

company_namestring

1–200 characters

titlestring

1–200 characters

fbcstring

1–500 characters

fbpstring

1–500 characters

gclidstring

1–500 characters

gbraidstring

1–500 characters

wbraidstring

1–500 characters

ttclidstring

1–500 characters

ttpstring

1–500 characters

li_fat_idstring

1–500 characters

epikstring

1–500 characters

sc_click_idstring

1–500 characters

sc_cookie1string

1–500 characters

rdt_cidstring

1–500 characters

twclidstring

1–500 characters

click_idstring

1–500 characters

lead_idstring

1–64 characters

uuidstring

1–200 characters

hashedboolean
user_agentstring

1–1024 characters

Returns object

objectstringrequired

conversion_adjustment_result

platformstring
ad_account_idstring
destination_idstring
adjustments_receivedinteger
adjustments_failedinteger
failuresarray of object
Show 3 item attributes
indexinteger
messagestring
codestring | null
trace_idstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/ads/conversions/adjustments
curl -X POST "https://api.socialit.com/v1/ads/conversions/adjustments" \
  -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",
    "destination_id": "string",
    "adjustments": [
      {
        "adjustment_type": "RETRACTION",
        "adjustment_time": "string"
      }
    ]
  }'
Response · 200

Get Event Match Quality

GET/ads/conversions/quality

Access: readZernio: GET /v1/ads/conversions/quality

Try it with MCPAsk your agent to call get-event-match-quality (toolset ads_measurement)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 has several ad accounts

≤ 80 characters

platform_ad_account_idstring

Network ad account id (act_…, customer id, advertiser id …)

≤ 256 characters

destination_idstring

1–256 characters

Returns object

objectstringrequired

event_match_quality

platformstring
destination_idstring
rowsarray of object
Show 4 item attributes
event_namestring | null
composite_scorenumber | null
match_keysarray of object
Show 2 item attributes
identifierstring | null
coverage_percentagenumber | null
event_coverage_percentagenumber | null

Responses

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