Zernio
Zernio
API Reference

Pixels & Tracking Tags

Tags

List tracking tagsGETCreate a tracking tagPOSTGet a tracking tagGETUpdate a tracking tagPATCHGet aggregated event statsGETGet tag diagnosticsGET

Conversion Events

List conversion eventsGETCreate a conversion eventPOSTUpdate a conversion eventPATCHDelete a conversion eventDELETE

Sharing

List accounts it is shared withGETShare with an ad accountPOSTStop sharing with an accountDELETE

Store Install

Install on a Shopify store or WordPress sitePOSTGet store install statusGETRemove from a Shopify store or WordPress siteDELETE

Ad URL Tracking Tags

Get ad tracking tagsGETSet ad tracking tagsPATCH

Other

Assign a user to a tagPOSTList partner businesses of a tagGETList tag usersGETRemove a user from a tagDELETE
Dashboard
llms.txtOpenAPI
OverviewPlatformsAPI ReferenceResources
Pixels & Tracking Tags

Delete a conversion event

Removes the conversion event. Platforms without a hard delete archive or disable it instead; state in the response says which (deleted, archived, disabled).

OpenAI Ads answers 501: there is no delete or archive route for event settings (DELETE /v1/conversions/event_settings/{id} and POST .../{id}/archive answer 404 "Invalid URL"). Archive the event in OpenAI Ads Manager.

LinkedIn (linkedinads): LinkedIn has no delete for conversion rules (not in the conversion-tracking API, and DELETE /rest/conversions/{id} has no route), so the rule is disabled (enabled: false) and state is disabled. Re-enable it with enabled: true.

Meta: archived. Meta's delete archives the custom conversion (it stays readable with status: archived) and there is no hard delete; deleting an archived one is a no-op.

Google Ads (googleads): removes the conversion action (state archived). Google keeps it with status REMOVED and its history; PATCH with enabled: true restores it. Deleting an already archived action succeeds without a call to Google.

Pinterest (platform pinterestads): stops Pinterest tracking the event name (state: disabled); Pinterest keeps the event's history.

TikTok: hard delete (/pixel/event/delete/); TikTok refuses events bound to an ad group (400).

PlatformsMetaGoogleTikTokLinkedInPinterestXOpenAI
DELETE
/v1/accounts/{accountId}/tracking-tags/{tagId}/events/{eventId}

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

In: header

Path Parameters

accountId*string
tagId*string
eventId*string

Event id (TrackingTagEvent.id).

Query Parameters

adAccountId?string

Scopes the lookup on platforms whose tag ids live inside an ad account.

Response Body

application/json

application/json

application/json

application/json

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.trackingtags.deleteTrackingTagEvent({  path: {    accountId: 'account_abc123',    tagId: 'tag_abc123',    eventId: 'event_abc123',  },});console.log(data);
{  "platform": "string",  "eventId": "string",  "state": "deleted"}
Was this page helpful?

Update a conversion event

Partial update; at least one field. A field the platform does not store answers 400. OpenAI Ads answers 501: OpenAI documents only list and create for event settings, and `POST`/`PATCH`/`PUT /v1/conversions/event_settings/{id}` answer 404 "Invalid URL". Create a new event instead. LinkedIn (`linkedinads`): partial update of the conversion rule; same fields as create. Pass `adAccountId` when the rule lives in another ad account than the one that created the tag. Meta: only `name` and `defaultValue` can change (Meta's custom conversion update takes nothing else); `type`, `siteEvent` and `urlContains` answer 400, create a new event instead. Google Ads (`googleads`): same fields as create, on the account's WEBPAGE actions (others answer 404). `enabled: false` archives the action (same as DELETE) and `enabled: true` restores an archived one. Pinterest (platform `pinterestads`): remaps the event to another `type` or `siteEvent`. Pinterest identifies the event by its name, so `name` cannot change (400): create the new name and delete the old one. TikTok: `name`, `defaultValue` and `currency` (USD, JPY or INR); the type cannot change (delete and recreate).

List accounts it is shared with

Meta (`metaads`) and LinkedIn (`linkedinads`); other platforms return 501. LinkedIn (`linkedinads`): the ad accounts this connection can see that hold access to the Insight Tag; the role (`FULL` or `USE_ONLY`) is appended to `name`. LinkedIn exposes permissions per ad account only, so accounts the connection cannot see are not listed. TikTok (`tiktokads`): the advertisers linked to the pixel in its Business Center (`/bc/pixel/link/get/`); a pixel outside Business Center answers 400.