Skip to main content

Tools index

This page provides an index of the tools available within the IQM Model Context Protocol (MCP) ecosystem. Each tool allows your AI assistant to interact with different aspects of the platform, enabling you to perform tasks efficiently and effectively.

Tools are grouped below by API. Each entry includes the tool name, a brief description, and a link to the corresponding API documentation for more details on its functionality and usage.

Asset API​

The Asset API streamlines the management and storage of media files. See the Asset tutorial or the Asset API guidelines for more information.

Asset details​

Tool nameDescriptionDocumentation
getAllAssetsGet a list of all assets in the workspaceGet a list of all assets
getAssetDetailsGet the details of an asset by IDGet asset details

Assets management​

Tool nameDescriptionDocumentation
addAssetsUpload one or more new assetsAdd multiple assets
updateAssetDetailsUpdate the details of an existing assetUpdate asset details
deleteAssetSoft-delete an asset by IDDelete asset

Audience API​

The Audience API allows you to create, manage, and target the many types of audiences available on the IQM platform. See the Audience tutorial or the Audience API guidelines for more information.

Audience management​

Tool nameDescriptionDocumentation
updateAudienceNameUpdate an audience's nameUpdate audience name
regenerateAudienceRegenerate a failed audienceRegenerate audience
deleteAudiencesDelete one or more audiences by IDDelete audience
attachDataPartnerToAudienceAttach a data partner to an audienceAttach data partner
getAudienceInsightsGet a demographic and geographic insights profile for an audienceGet audience Insights
generateInsightsForMatchedAudienceGenerate an Audience Insights report for one or more audiencesCreate Audience Insights report

Audience lists and counts​

Tool nameDescriptionDocumentation
getAudienceListGet a detailed list of audiences with insights detailsAudience details list
getAudienceBasicListGet a basic list of audiencesBasic audience details
getAudienceCountByStatusGet audience counts grouped by statusAudience count by status
getAudienceCountByTypeGet audience counts grouped by typeAudience count by type

Matched audiences​

Tool nameDescriptionDocumentation
createMatchedAudience_1Create a matched audience for any vertical or subtypeCreate Matched audience
updateMatchedAudienceUpdate the details of a matched audienceUpdate Matched audience
rematchMatchedAudienceRematch or refresh a matched audienceRefresh Matched audience
getMatchedAudienceByIdGet matched audience details by IDMatched audience details
getAudienceFileUrlGet a presigned download URL for an audience file
getDataFormatsGet the list of supported data formats for matched audiencesData formats list for Matched audience
getAudienceDataPartnersGet matched audience data partners by vertical and subtypeData partners list for Matched audience
getAudienceColumnWithDataFormatsGet matched audience columns by type, vertical, and subtypeMatched column list
getAudienceColumnCombinationsGet valid matched audience column combinationsMatched column combinations

Segmented audiences​

Tool nameDescriptionDocumentation
createSegmentedAudienceCreate a new segmented audienceCreate Segmented audience
updateSegmentedAudienceUpdate an existing segmented audienceUpdate Segmented audience
getSegmentedAudienceGet segmented audience details by IDSegmented audience details
getSegmentsSearchListSearch the segments listSearch Segmented audiences
downloadSegmentsSearchListDownload the segments search list
getSegmentPartnerProviderListGet the list of segment partner providersSegment partner provider list
getSegmentsListByParentOrProviderGet segments by parent or provider IDSegment list by provider/partner IDs
getSegmentReachRangeGet the reach range list for segmentsReach range list for Segmented audiences
getSegmentPriceRangeGet the price range list for segmentsPrice range list for Segmented audiences

Retargeted audiences​

Tool nameDescriptionDocumentation
createRetargetedAudienceCreate a new retargeted audienceCreate Retargeted audience
updateRetargetedAudienceUpdate an existing retargeted audienceUpdate Retargeted audience
sendRetargetedPixelCodeEmailEmail a retargeted audience's pixel code to recipientsRetargeted audience email notification

Geofarmed audiences​

Tool nameDescriptionDocumentation
createGeoFarmedAudienceCreate a new geofarmed audienceCreate Geofarmed audience
getGeofarmedAudienceGet geofarmed audience details by IDGeofarmed audience details

Contextual audiences​

Tool nameDescriptionDocumentation
createContextualAudiencesCreate a new contextual audienceCreate Contextual audience
getContextualAudienceDetailsGet contextual audience details by IDContextual audience details
validateProgrammaticUrlsValidate URLs for contextual audience targetingValidate URL for Contextual audience

Lookalike audiences​

Tool nameDescriptionDocumentation
createLookalikeAudienceCreate a new lookalike audienceCreate Lookalike audience
getLookalikeAudienceByIdGet lookalike audience details by IDGet Lookalike audience details

Campaign audiences​

Tool nameDescriptionDocumentation
createCampaignAudienceCreate a new campaign audienceCreate Campaign audience
getCampaignAudienceGet campaign audience details by IDCampaign audience details
getAttachedAudienceHistoryGet attached audience history for campaignsGet Campaign audience history

Pre-bid audiences​

Tool nameDescriptionDocumentation
createPrebidAudienceCreate a new pre-bid audienceCreate Pre-bid audience
updatePrebidAudienceUpdate an existing pre-bid audienceUpdate Pre-bid audience
getPrebidAudienceDetailsGet pre-bid audience details by IDPre-bid audience details
getPrebidSegmentDetailsBySearchSearch pre-bid segment details by text or segment IDsSearch Pre-bid audience details
getProviderDetailsWithChildSegmentsGet pre-bid providers and their immediate child segmentsGet pre-bid provider child segment details
getPrebidChildSegmentDetailsByParentIdGet pre-bid child segment details by parent IDGet pre-bid child segment details
getDvIvtFreePrebidSegmentsGet pre-bid segments that are free of DV-IVT chargesDoubleVerify Pre-bid audience segment details

ABM and Healthcare audiences​

Tool nameDescriptionDocumentation
createAbmAudienceCreate a new ABM audienceCreate ABM audience
getAccountBasedAudienceDetailsByAudienceIdGet ABM audience details by IDABM audience details
getHealthcareDataFiltersFromFileExtract ABM filters from an uploaded fileUpload ABM filter file
getHealthcareTitleListGet the list of healthcare titlesHealthcare titles list
getHealthcareSpecialityListGet the list of healthcare specialtiesHealthcare specialties list
getHealthcareSystemListGet the list of healthcare systemsHealthcare systems list
getHealthcareDataGet a list of healthcare data by filtersHealthcare data
getHealthcareDataStatisticsGet healthcare data statistics by filtersHealthcare statistics
getAccountTypeListGet the list of healthcare account typesHealthcare account types
getAccountSubTypeListGet the list of healthcare account subtypesHealthcare account subtypes
getAccountNameListGet the list of healthcare account namesHealthcare account names

ICT audiences​

Tool nameDescriptionDocumentation
createICTAudienceCreate an ICT audience with optional extension audiencesCreate ICT audience
getIctAudienceDetailsByAudienceIdGet ICT audience details by IDGet ICT audience details
getAudienceSubTypesWithExtensionSubTypesGet ICT audience subtypes with extension subtypesICT audience subtypes and extensions
getAudienceCountByDataPartnerGet ICT audience counts grouped by data partnerGet ICT audience count by data partner

Custom Voter Audiences (CVA)​

Tool nameDescriptionDocumentation
createCustomVoterAudienceCreate a new Custom Voter AudienceCreate Custom Voter Audience
getCustomVoterAudienceDetailsByAudienceIdGet Custom Voter Audience details by IDGet Custom Voter Audience details
getSegmentDetailsGet segment details from the Custom Voter Audience segment catalogueGet Custom Voter Audience segment details
getStatesGet the list of states available for Custom Voter AudiencesGet available states for Custom Voter Audiences

Static / reference data​

Tool nameDescriptionDocumentation
getAudienceTypesGet the list of audience typesAudience type list
getAudienceSubtypesGet the list of audience subtypesAudience subtype list
getAudienceStatusesGet the list of audience statusesAudience status list
getFrequencyTypesGet the list of active frequency typesFrequency type list
getAudiencePropertiesGet platform configuration properties for audiences

Bid Model API​

The Bid Model API allows you to fine-tune campaign delivery by prioritizing and adjusting spend across dimensions like Creative, Location, and Inventory. See the Bid Model tutorial or the Bid Model API guidelines for more information.

Bid Model details​

Tool nameDescriptionDocumentation
getBundleDetailsList_1Get a list of bundles for a campaign and dimension, with entity and modeling status detailsGet list of Bid Model Bundles
getModelledEntityDataGet modeled entity data for a dimensionGet modeled entities
getDimensionStatisticsGet dimension-wise counts of modeled items for a campaignGet campaign dimension statistics
getDimensionWiseEntitySpentForCampaign_1Get dimension-wise spend for a campaignGet dimension specific spending for a campaign
getModelledItemsForCampaignAndDimensionIdGet modeled entities and modeling data for a campaign and dimensionGet list of modeled entities for a campaign

Include/exclude management​

Tool nameDescriptionDocumentation
toggleCampaignDimensionStatusInclude or exclude entities from a campaignInclude/exclude entities from a campaign

Bid Model management​

Tool nameDescriptionDocumentation
manageBidModellingManage bid modeling attributes for a campaign and dimensionManage Bid Model settings
createBundle_1Create a bundle for a campaign and dimensionCreate Bid Model Bundle
updateBundleDetails_1Update a bundle for a campaign and dimensionUpdate Bid Model Bundle
deleteBundle_1Delete a bundle for a campaign and dimensionDelete Bid Model Bundle

Bid Model metrics and dimensions​

Tool nameDescriptionDocumentation
fetchCampaignMetricsByDimensionGet a metrics report for a campaign by dimensionGet metrics report for a given campaign and dimension
getDimensionsGet the list of bid model dimensionsGet list of Bid Model dimensions

Campaign API​

The Campaign API allows you to create and manage campaigns, insertion orders, and their targeting settings. See the Campaign tutorial or the Campaign API guidelines for more information.

Insertion orders​

Tool nameDescriptionDocumentation
createCampaignIOCreate a new insertion orderCreate an insertion order
editIODetailsUpdate an existing insertion orderUpdate insertion order details
getIOBasicDetailsListList IOs with filters (status, budget type, owner)Get insertion order details
getBasicIODetailsByIdFetch one IO by IDGet insertion order details by ID
getIoMappedWithCampaignsDetailsList IOs with their attached campaignsGet list of campaign details grouped by insertion order ID
duplicateIOClone an existing IODuplicate an insertion order
updateIOStatusToDeleteSoft-delete an IODelete an insertion order

Advanced campaigns​

Tool nameDescriptionDocumentation
saveCampaignCreate an advanced campaign in pending statusCreate new campaign
saveDraftCampaignCreate an advanced campaign in draft status
editCampaignPatchUpdate a campaign (auto-promotes draft to pending)Update campaign
editDraftCampaignUpdate a draft campaign
duplicateCampaignClone an existing campaignDuplicate campaigns
updateCampaignStatusUpdate a campaign's statusUpdate campaign status
updateCampaignBudgetUpdate budgets without touching other fieldsChange campaign budget

PG campaigns​

Tool nameDescriptionDocumentation
addPGCampaignCreate a PG campaignCreate new PG campaign
addDraftPGCampaignCreate a PG campaign in draft status
editPGCampaignUpdate a PG campaignUpdate PG campaign
editDraftPGCampaignUpdate a draft PG campaign

Campaign details​

Tool nameDescriptionDocumentation
getCampaignFetch full details of one campaignGet campaign details by ID
getCampaignBasicDetailListPaginated list with rich filters (type, status, IO, creative type)Get basic details of campaigns
getCampaignListDataGet a list of campaignsGet list of campaigns
getCampaignBudgetInfoGet budget info and graph details for a campaignGet campaign budget details
getCostDetailsGet cost details for a campaignGet campaign cost details

Campaign targeting​

Tool nameDescriptionDocumentation
CampaignAudienceTargetingListBulk include/exclude/remove audiences across many campaigns (map-keyed by campaign ID)Update audience targeting in campaigns
createCampaignCreativeTargetingBulk assign/unassign creatives to campaignsUpdate creative targeting in campaigns
managePMPDealCampaignMappingsBulk assign/de-assign PMP deals to campaignsAssign PMP deals
managePgDealCampaignMappingsBulk assign/de-assign PG deals to campaignsAssign PG deals
includeExcludeInventoryGroupInclude or exclude campaigns from one or more inventory groupsInclude/exclude campaigns from inventory groups

Conversion API​

The Conversion API allows you to create and manage conversions, and assign them to campaigns to track performance. See the Conversion tutorial or the Conversion API guidelines for more information.

Conversion details​

Tool nameDescriptionDocumentation
getConversionDetailsByIdGet conversion details by IDGet conversion details by ID
getConversionListGet a list of conversionsGet list of conversions
getConversionCountTypeWiseGet conversion counts grouped by typeGet conversion count by type
getAttachedCampaignsListByConversionIdGet campaigns attached to a conversionGet campaign details by conversion ID
getAttachableCampaignListByConversionIdsGet campaigns that can be attached to one or more conversionsGet campaign details by conversion ID in group or basic

Conversions management​

Tool nameDescriptionDocumentation
addPostbackConversionCreate a postback conversionCreate Postback conversion
addPixelConversionCreate a pixel conversionCreate Pixel conversion
universal-pixel-conversion-addCreate a universal pixel conversionCreate a Universal Pixel conversion
deleteConversionsDelete one or more conversionsDelete conversion
updateConversionUpdate a postback conversionUpdate Postback conversion
updateConversion_1Update a pixel conversionUpdate Pixel conversion
universal-pixel-conversion-updateUpdate the name of a universal pixel conversionUpdate a Universal Pixel conversion
assignConversionToCampaignAssign a conversion to a campaignAssign conversion to a campaign
sendEmailForPixelConversionEmail pixel integration instructionsSend email for Pixel integration
universal-pixel-send-emailEmail universal pixel integration instructionsSend email for Universal Pixel integration

More conversion details​

Tool nameDescriptionDocumentation
getListOfConversionPartnerTypeGet the list of postback partner typesGet list of partner types for Postback conversions
getConversionDefaultAdvancedSettingDataGet default advanced setting values for pixel conversionsGet list of Pixel conversion advanced setting default values
getListOfConversionTypesGet the list of conversion typesGet list of conversion types
getListOfConversionStatusGet the list of conversion statusesGet list of conversion status
getListOfConversionPiggybackTypesGet the list of conversion piggyback typesGet list of conversion piggyback types
getListOfConversionAttributionTypesGet the list of conversion attribution typesGet list of conversion property types

Creative API​

The Creative API allows you to upload and manage creatives and assign them to campaigns. See the Creative tutorial or the Creative API guidelines for more information.

Creative details​

Tool nameDescriptionDocumentation
getCreativeGet creative details by IDCreative details by ID
getCreatives_1Get a list of creatives and their detailsGet list of creatives and details
getCreativeAndCampaignDetailsGet a creative and its associated campaignsGet associated campaigns

Creative management​

Tool nameDescriptionDocumentation
createCreativesAdd a new creativeAdd new creative
updateCreativeUpdate the details of an existing creativeUpdate creative details
updateCreativeStatusUpdate a creative's statusUpdate creative status
createCampaignCreativeTargetingBulk assign or unassign creatives to campaignsUpdate creative targeting in campaigns

Creative groups​

Tool nameDescriptionDocumentation
getCreativeGroupListGet a list of creative groupsGet list of creative groups
createCreativeGroupCreate a new creative groupCreate new creative group
modifyCreativesInGroupsAdd or remove creatives from creative groupsUpdate creative groups
duplicateCreativeGroupDuplicate a creative group by IDDuplicate creative group
deleteCreativeGroupsDelete creative group(s) by IDDelete creative group

Finance API​

The Finance API allows you to manage Customer and Organization finances, including margins, invoices, payments, and credits. See the Finance API guidelines for more information.

Finance details​

Tool nameDescriptionDocumentation
getCustomerOverviewGet customer overviewGet Customer finance details
getBasicDetailsGet basic finance detailsGet basic financial details
getAvailableBalance_1Get available balanceAvailable balance
getCustomerMarginGet customer margin detailsGet Customer margin details
editCustomerMarginEdit customer margin detailsUpdate Customer margin details
getMarginSettingsGet margin settings for the workspaceGet Organization margin settings
updateMarginSettingsUpdate margin settings for the workspaceUpdate Organization margin settings
getCampaignMarginListGet campaign-wise margin listCampaign margin details
getPgFeesDetailsGet customer PG fees detailsGet Customer PG fees details
editPgFeesDetailsEdit customer PG fees detailsEdit Customer PG fees
getDvIvtFlagFetch DV-IVT free segments flagGet Customer DoubleVerify details
updateDvIvtFlagUpdate DV-IVT free segments flagUpdate Customer DoubleVerify
addAdServingCostAdd ad serving costAdd ad serving cost
getAdServingCostGet ad serving costGet ad serving cost
addThirdPartyCostAdd or update third party costAdd or update third party cost
getThirdPartyCost_1Get third party costGet third party cost
disableThirdPartyCostDisable third party costDisable third party cost
getInsightFeesGet insight fees detailsGet Customer Insights fees details
updateInsightFeesUpdate insight fees detailsUpdate Customer Insights fees details

Invoice management​

Tool nameDescriptionDocumentation
getInvoiceDetails_1Get invoice for organizationGet invoice for Organization
getInvoicePaymentDetailsGet invoice payment detailsGet invoice payment details
getInvoiceDetailsList invoices for customer or organizationGet list of invoices for Customer or Organization
updateInvoiceSettingsDetailsForOrganizationSave or update invoice settingsUpdate invoice settings
deleteTaxDataDelete invoice tax dataDelete invoice tax data
approveInvoiceApprove invoiceApprove invoice
cancelInvoiceCancel invoiceCancel invoice
payInvoiceMark invoice as paidMark invoice as paid
emailInvoice_1Email invoiceEmail invoice
getInvoiceTemplateMarginDetailsGet invoice template margin detailsGet invoice template margin details
getInvoiceTemplateMarginDetails_1Get invoice template margin pre-requisiteGet invoice template margin pre-requisite

Static details​

Tool nameDescriptionDocumentation
getPaymentTypesPayment typesPayment types
getPaymentStatusesPayment statusPayment status
getPaymentModesInvoice payment mode typesInvoice payment mode types
getInvoiceStatusesInvoice statusInvoice status
getPaymentTermsInvoice payment termInvoice payment term
getPgPaymentTypesPG payment typesPG payment type

Inventory API​

The Inventory API allows you to browse Open Exchange, Contextual, Private Marketplace (PMP), and Programmatic Guaranteed (PG) inventory, and manage inventory groups and deals. See the Inventory tutorial or the Inventory API guidelines for more information.

PMP deals​

Tool nameDescriptionDocumentation
addPMPDealCreate a new PMP dealCreate PMP deal
editPMPDealEdit an existing PMP dealUpdate PMP deal
deletePMPDealDelete one or more PMP dealsDelete PMP deal
getPMPDealDetailsGet PMP deal details including assigned campaign IDsGet PMP deal details by IDs
getPMPDealListGet a paginated list of PMP dealsGet PMP deals list
getPMPDealsCountByStatusGet count of PMP deals by statusGet count of PMP deals for all statuses
getPMPAndPGDealsGet a list of PMP and PG deals for report filteringList of deals
getGroupPMPDealsGet PMP deals in an inventory groupGet list of PMP deals in an inventory group
generateGroupPMPDealsFileDownload a CSV of PMP deal details for a groupGet CSV list of PMP deals in an inventory group
fetchAssociatedCustomersForPMPDealGet customers associated with a PMP deal's campaignsGet list of Customers associated with campaigns for a PMP deal
getDealStatusesGet a list of deal statusesGet list of deal statuses
getDealTypesGet a list of deal typesGet list of deal types

PG deals​

Tool nameDescriptionDocumentation
addPGDealCreate a new PG dealCreate PG deal
updatePGDealUpdate an existing PG dealUpdate PG deal details
deletePGDealsDelete multiple PG deals by their IDsDelete PG deal
fetchPGDealListGet a paginated list of PG dealsGet PG deals list
getPGDealByIdGet PG deal details with associated campaign IDsGet PG deals details by ID

Inventory groups​

Tool nameDescriptionDocumentation
addInventoryGroupCreate a new inventory groupCreate a new inventory group
editInventoryGroupEdit an existing inventory groupEdit inventory group
deleteInventoryGroupDelete an inventory groupDelete inventory group
validateInventoryGroupValidate an inventory group nameValidate inventory group
getInventoryGroupsGet a paginated list of inventory groupsGet list of inventory groups
getInventoryGroupsCountGet the count of inventory groupsGet inventory groups count
getInventoryGroupsStatisticsGet aggregate statistics for inventory groupsGet list of inventory groups statistics
getInventoryGroupTypesGet a list of inventory group typesGet inventory group types
addMappingsToInventoryGroupsAdd inventories to one or more inventory groupsAdd or remove mappings to an inventory group
removeMappingsOfInventoryGroupRemove inventories from an inventory group
includeExcludeInventoryInclude or exclude inventory for a campaignCampaign inventory targeting

Open Exchange inventories​

Tool nameDescriptionDocumentation
getInventoriesDetailsGet open exchange inventory details with filteringGet list of inventories
getInventoriesCountDetailsGet count of open exchange inventoriesGet inventories count
getInventoriesDistributionDetailsGet distribution of inventories across dimensionsGet inventory distribution
getInventoriesByCSVGet inventories based on an uploaded CSV fileGet inventory based on CSV file
getInventoriesCountByCSVGet inventory counts based on an uploaded CSV fileGet inventory count based on CSV file
getInventoriesDistributionsByCSVGet inventory distributions based on an uploaded CSV fileGet distribution of inventory based on CSV file
getGroupInventoriesGet open exchange inventories in a groupGet list of Open Exchange inventories in an inventory group
getGroupInventoriesStatisticsGet statistics for inventories in a groupGet count of Open Exchange inventories in an inventory group
getGroupInventoriesDistributionsGet distribution breakdown of inventories in a groupGet distributions of Open Exchange inventories in an inventory group
downloadOpenExchangeInventoryDetailsDownload open exchange inventory detailsDownload CSV inventory list
downloadOpenExchangeInventoryDetailsByGroupIdDownload open exchange inventory details for a groupDownload Open Exchange inventories for group

Contextual inventories​

Tool nameDescriptionDocumentation
addContextualInventoriesAdd contextual inventories with keywords and URLsAdd Contextual inventories
removeContextualInventoriesRemove contextual inventoriesRemove Contextual inventories
getContextualInventoriesGet a paginated list of contextual inventoriesFetch Contextual inventories
addMappingsToInventoryGroups_1Add contextual inventory mappings to one or more inventory groupsAdd Contextual inventories to inventory groups
removeMappingsFromInventoryGroupRemove contextual inventory mappings from an inventory groupRemove Contextual inventories from group
getContextualInventoriesForGroupGet contextual inventories for a groupGet list of Contextual inventories for an inventory group
getContextualInventoriesForGroupCountGet count of contextual inventories for a groupGet count of Contextual inventories for an inventory group
generateGroupContextualInventoriesFileDownload contextual inventories CSV for a groupGet CSV file of Contextual inventories for an inventory group
getRecommendedKeywordsGet recommended keywords for contextual targetingContextual inventory
getAutoSuggestKeywordsGet autosuggested keywords for contextual targeting

Blocked inventories​

Tool nameDescriptionDocumentation
addInventoriesToBlockedListAdd inventories to the blocked listBlock inventories
blockInventoriesToBlockedListViaFileBlock inventories via an uploaded fileBlock inventory file
unblockInventoriesFromBlockedListRemove inventories from the blocked listUnblock inventories
getBlockedInventoriesGet list of blocked open exchange inventoriesGet list of blocked inventories
addCommentForInventoryBlockingAdd a comment for a blocked inventoryAdd comment for blocked inventory

Reports API​

The Reports API allows you to create, execute, and schedule reports on campaign performance data. See the Reports tutorial or the Reports API guidelines for more information.

Report details​

Tool nameDescriptionDocumentation
getReportListGet a list of reportsGet a list of reports
fetchReportListGet a list of reports with filters
getReportGet report details by IDGet report by ID

Reports management​

Tool nameDescriptionDocumentation
saveReportCreate a new reportCreate report
executeReportDataExecute a report and fetch serving dataExecute a report
updateReportEdit an existing reportEdit a report
deleteReportDelete a report and its scheduling dataDelete a report

Scheduling management​

Tool nameDescriptionDocumentation
saveReportScheduleEventSchedule email delivery for a reportSchedule a report
updateReportScheduleEventUpdate a report's email scheduleUpdate a report schedule
deleteReportScheduleEventRemove a report's email scheduleDelete report schedule

More report details​

Tool nameDescriptionDocumentation
getDimensionAndMetricDetailsGet available dimensions and metrics for reportsGet dimensions and metrics details

User Management API​

The User Management API allows you to log in and out, manage user profiles and application access, and validate user credentials. See the User management tutorial or the User Management API guidelines for more information.

Users​

Tool nameDescriptionDocumentation
getUserOWIdGet the logged in user's owId
getAccessibleOrganizationsGet organizations accessible to the current user
getUsersListGet a paginated list of usersGet list of users
getUsersBasicListGet a basic paginated list of usersBasic user list
sendUserInvitationsSend an invitation to a new userSend user invitation
resendUserInvitationsResend an invitation to a userResend user invitation
updateUserStatusUpdate a user's active or inactive statusUpdate user status

Profile​

Tool nameDescriptionDocumentation
getProfileGet the current user's profile detailsGet user profile details
updateProfileDetailsUpdate the current user's profile informationUpdate user profile

App access​

Tool nameDescriptionDocumentation
getAllowedApplicationsGet a list of applications the user is permitted to accessAllowed applications list
getUserApplicationsAccessGet the user's application access listUser app access list
addApplicationAccessToUserAdd application access for a userAdd app access for user
revokeApplicationAccessToUserRevoke application access for a userRevoke app access for user
getRemainingApplicationsGet the remaining applications available to assign to a userRemaining applications

Password and MFA​

Tool nameDescriptionDocumentation
sendResetPasswordEmailSend a password reset emailReset password email
resetPasswordReset a user's passwordReset user password
updateMfaFlagEnable MFA for one or more usersEnable MFA
disableMfaForUsersDisable MFA for one or more usersDisable MFA

Validation​

Tool nameDescriptionDocumentation
validateInvitationValidate a user invitation linkValidate user invite
validateResetPasswordInvitationValidate a password reset linkValidate password reset hash
validateUserEmailValidate a user's email addressValidate user email
validateWorkspaceForUserValidate a workspace domain for a userValidate Workspace domain
validateCurrentPasswordValidate the current user's passwordValidate user password

Workspace API​

The Workspace API (backed by the same underlying User Management API service) allows you to manage Organizations, Customers, and Advertisers. See the Workspace tutorial or the Workspace API guidelines for more information.

Organization details​

Tool nameDescriptionDocumentation
getAllowedOrganizationsGet a list of allowed organizationsGet list of allowed Organizations
getOrganizationProfileGet the organization's profile detailsGet Organization details
getUserInteractionEventsGet a list of user interaction eventsGet list of user interaction events
upsertInteractionEventUpdate or insert a user interaction eventUpsert interaction event
isDomainAvailableCheck if a workspace domain is availableCheck for available domain
getOrganizationsApplications_1Get the list of applications available for organizationsOrganization applications list

Organization management​

Tool nameDescriptionDocumentation
updateOrganizationProfileUpdate the organization's profileUpdate Organization profile
updateOrganizationEmailUpdate the organization's email addressUpdate Organization email

Whitelabel settings​

Tool nameDescriptionDocumentation
getWhiteLabelSettingsGet the organization's whitelabel settingsGet whitelabel settings
updateWhiteLabelSettingsUpdate whitelabel settings for the organizationUpdate whitelabel settings
addWhiteLabelDomainAdd a whitelabel domain to the organizationAdd whitelabel domain
verifyWhiteLabelDomainVerify the organization's whitelabel domainVerify whitelabel domain
addWhiteLabelPixelUrlAdd a whitelabel pixel URL for the organizationAdd whitelabel pixel URL

Workspace management​

Tool nameDescriptionDocumentation
createWorkspaceCreate a new workspaceCreate a Workspace
getAdminUserListGet a list of admin usersGet list of admin users
updateWorkspaceDomainUpdate a workspace domainUpdate Workspace domain
getWorkspacesGet a list of workspacesGet list of Workspaces
getWorkspaceInitDetailsGet workspace initialization detailsGet Workspace initialization details
getWorkspaceOrganizationLogoGet the organization logo for a workspaceGet Workspace Organization logo
getWorkspaceChatBotAppIdByOwIdGet the chatbot app ID for a workspace by organization workspace IDGet Workspace chatbot app ID
getWorkspaceChatBotAppIdByWorkspaceDomainGet the chatbot app ID for a workspace by domainGet Workspace chatbot app ID by domain
sendFindMyWorkspaceEmailSend a "Find My Workspace" email to a userSend find my Workspace email

Customer details​

Tool nameDescriptionDocumentation
getCustomersListGet a detailed list of customersGet Customer details
getCustomerBasicDetailsGet a basic details list for customersGet basic Customer details
getMultiLevelOrganizationsGet a multi-level list of customersGet multi-level Customers list
getImmediateCustomersGet a list of immediate customersGet immediate Customers list
getCustomerOperationDetailsByIdGet customer operations details by customer IDGet Customer operations details
getCustomerOperationLabelsGet the list of labels for customer operationsGet Customer operations label list
getCustomerCountGet the count of customers grouped by statusGet count of Customers by status
getCustomersUsersGet the users assigned to a specific customerGet list of users for selected Customer
getUserAssignedCustomersGet the customers assigned to a userGet list of user assigned Customers
getRemainingCustomersForUserGet the remaining customers available for assignment to a userGet user's remaining Customers
getAllowedCustomersOWIdsGet the list of allowed customer organization workspace IDsGet allowed Customer OW IDs
getRemainingApplicationGet the remaining applications available to assign to a customerGet list of remaining apps for Customer
getMetabaseExternalServiceClientCredentialsGet Metabase external service client credentialsGet Metabase client credentials
getAdvertisersGet advertisers associated with a customerGet list of Advertisers for Customer

Customer management​

Tool nameDescriptionDocumentation
getInvitePreRequisiteGet pre-requisite details required before sending a customer invitationInvitation pre-requisite details
sendInvitationsInvite a customer to the platformInvite Customer to platform
resendCustomerInvitationResend a customer invitationResend Customer invite
cancelCustomerInvitationCancel a pending customer invitationCancel Customer invite
assignCustomersToUserAssign customers to a userAssign Customer to user
removeCustomersAssociationFromUserRemove a customer association from a userUnassign Customer from user
approveCustomerApprove a customer sign-up requestApprove Customer
rejectCustomerReject a customer sign-up requestReject Customer
addApplicationAccessToCustomerAdd application access for a customerAdd Customer app access
revokeApplicationAccessToCustomerRevoke application access for a customerRevoke Customer app access
putCustomerOnHoldSuspend a customer accountPut Customer on-hold
reactivateCustomerReactivate a suspended customer accountRe-activate Customer
addLabelForCustomerOperationAdd a label to a customer operationAdd label for Customer operation
updateIsBidShadingEnabledFlagEnable or disable bid shading for a customerEnable bid shading for Customer
updateCustomerOperationDetailsByOwIdUpdate customer operations detailsUpdate Customer operations details

Advertiser management​

Tool nameDescriptionDocumentation
getAdvertiserProfilesGet a list of advertiser profiles and detailsGet list of Advertiser profile and details
addAdvertiserProfileAdd a new advertiser profileAdd Advertiser profile
updateAdvertiserProfileEdit an existing advertiser profileEdit Advertiser profile
deleteAdvertiserProfileDelete an advertiser profileDelete Advertiser profile

Static details lists​

Tool nameDescriptionDocumentation
getOrganizationWorkspaceStatusGet the list of organization-workspace status optionsOrganization Workspace status
getUserOrganizationWorkspaceStatusGet the list of user status optionsUser status
getCustomerTypeGet the list of customer type optionsCustomer type
getCustomerPaymentTypeGet the list of customer payment type optionsCustomer payment type
getCustomerAccountTypeGet the list of customer account type optionsCustomer account type
getCustomerListSortableFieldsGet the list of sortable fields for customer listsCustomer list sortable fields
getUserSortByGet the list of sort-by options for usersUser sort by options
getOrganizationExpertizeGet the list of organization expertise optionsOrganization expertise
getCompanySizeGet the list of company size optionsCompany size
getIndustriesGet the list of industry optionsIndustries
getMediaBudgetGet the list of media budget optionsMedia budget
getVerticalsGet the list of available verticalsVerticals

Insights API​

The Insights API allows you to generate Audience and Campaign Bidding Insights, and manage Voter Level Data (VLD), Script Lift Study (SLS), Audience Quality (AQ), and Provider Level Data (PLD) Insights report templates and schedules. See the Insights tutorial or the Insights API guidelines for more information.

Insights report details​

Tool nameDescriptionDocumentation
getInsightsDetailListGet a list of Insights reportsGet a list of Insights reports
getCampaignBiddingInsightGet Campaign Bidding Insights data for a campaignGet Campaign Bidding Insights
getInsightsTypeWiseCountGet Insights report counts grouped by typeGet Insights reports count by type
getStatusWiseCampaignsForInsightsReportsGet a status-wise list of campaigns eligible for Insights reportsGet eligible campaigns
computeInsightsReportsCompute Insights reports for the given campaignsCalculate Insights computation

Insights report management​

Tool nameDescriptionDocumentation
deleteInsightsDelete Insights report records by IDDelete Insights report record
regenerateInsightsRegenerate a failed Insights reportRegenerate Insights report
sendInsightsEmailEmail an Insights report to recipientsSend Insights report email

Audience Insights report​

Tool nameDescriptionDocumentation
getInsightsCreateEligibleAudienceListGet a list of audiences eligible for Audience Insights report generationGet a list of eligible audiences
createInsightsDetailsCreate an Audience Insights report for one or more audiencesCreate Audience Insights report
downloadInsightsDownload an Audience Insights report (PDF or XLSX)Download Insights report

Power Segment Insights (PSI)​

Tool nameDescriptionDocumentation
generateReportGenerate a Power Segment Insights reportGenerate PSI report
getPowerSegmentsDetailListGet a list of Power Segment Insights reportsGet Power Segment Insights list
downloadReportDownload a Power Segment Insights reportDownload PSI report
sendReportEmailEmail a Power Segment Insights report to recipientsEmail PSI report
getPsiCategoryTypesGet the list of Power Segment Insights category typesGet Power Segment Insights category types

Audience Quality (AQ) Insights reports​

Tool nameDescriptionDocumentation
getReportDetailListGet a paginated list of AQ Insights reportsGet list of AQ Insights reports
getStatusWiseCampaignsForReportsGet a status-wise list of campaigns eligible for AQ Insights reportsGet list of campaigns eligible for AQ Insights reports
validateAQSReportNameValidate an AQ Insights report nameValidate AQ Insights report name
computeReportsGet cost and impression estimates for an AQ Insights reportCompute AQ Insights report cost
generateAQReportsGenerate an AQ Insights reportGenerate AQ Insights report
getAQSReportTypesGet the list of available AQ Insights report typesGet AQ Insights report types
getAQSReportDownloadUrlDownload an AQ Insights reportDownload AQ Insights report
deleteFailedReportsDelete a failed AQ Insights reportDelete AQ Insights report
emailEmail an AQ Insights report to recipients

Voter Level Data (VLD) Insights reports​

Tool nameDescriptionDocumentation
getVLDReportListGet a list of VLD Insights reportsGet list of VLD Insights reports
getStatusWiseCampaignsForVLDReportsGet a list of campaigns eligible for VLD Insights reportsGet list of campaigns eligible for VLD Insights reports
generateVLDReportsGenerate a VLD Insights reportGenerate VLD Insights report
getChargeableImpressionsDataForVLDReportsGet cost and impression estimates for a VLD Insights reportGet cost assessment for VLD Insights report
getVLDReportDownloadUrlDownload a VLD Insights reportDownload VLD Insights report
deleteFailedVLDReportDelete a failed VLD Insights reportDelete VLD Insights report
sendMailForVlDReportEmail a VLD Insights report to recipients

Script Lift Study (SLS) Insights reports​

Tool nameDescriptionDocumentation
getSLSReportListGet a list of SLS Insights reportsGet list of SLS Insights reports
getStatusWiseCampaignsForSLSReportsGet a status-wise list of campaigns eligible for SLS Insights reportsGet list of campaigns eligible for SLS Insights reports
generateSLSReportsGenerate an SLS Insights reportGenerate SLS Insights report
getChargeableImpressionsDataForSLSReportsGet cost and impression estimates for an SLS Insights reportSLS Insights reports computation
validateSlsReportNameValidate an SLS Insights report nameValidate SLS Insights report name
getSLSReportDownloadUrlDownload an SLS Insights reportDownload SLS Insights report
deleteFailedSLSReportDelete a failed SLS Insights reportDelete SLS Insights report
sendMailForSlsReportEmail an SLS Insights report to recipients

Provider Level Data (PLD) Insights reports​

Tool nameDescriptionDocumentation
getPLDReportListGet a list of PLD Insights reports
generatePLDReportsGenerate a PLD Insights report
getChargeableImpressionsDataForPLDReportsGet cost and impression estimates for a PLD Insights report
fetchPLDReportSelectedColumnsGet the user-selected columns for PLD Insights reports
saveOrUpdatePLDReportSelectedColumnsSave or update the user-selected columns for PLD Insights reports
getReportIntervalGet the reporting interval for a PLD Insights report template

Report templates​

Tool nameDescriptionDocumentation
getTemplatesGet a list of report templatesGet list of templates
createTemplateCreate a report templateCreate report template
updateTemplateUpdate a report templateUpdate report template
validateTemplateNameValidate a report template nameValidate template name
getTemplateByIdGet report template details by IDGet template details
getReportsForTemplateGet the reports generated for a templateGet template reports

Report management​

Tool nameDescriptionDocumentation
getReportDownloadUrlDownload an Insights reportDownload report
deleteFailedReportDelete a failed reportDelete report
sendMailForReportEmail an Insights report to recipientsEmail report
regenerateReportsRegenerate a failed schedulable reportRegenerate report

Static / reference data​

Tool nameDescriptionDocumentation
getInsightsTypeGet the list of Insights typesGet list of Insights types
getInsightsStatusGet the list of Insights status typesGet list of Insights status types
getTemplateStatusesGet the list of template status typesGet list of template status types
getFrequencyMetadataGet delivery frequency metadata for scheduling templatesGet scheduling frequencies
getReportStatusesGet the list of report statuses
getPropertiesOfReportsGet environment-wide default report properties

Dashboard API​

The Dashboard API allows you to manage dashboards, generate campaign performance reports, and review Goal-AI optimization and CampaignPulse data. See the Dashboard API guidelines for more information.

Dashboard details​

Tool nameDescriptionDocumentation
getDashBoardListGet a list of dashboardsDashboard list
getGoalAIOptimizationReportGet Goal-AI optimization graph data for a campaignGet campaign AI-Based Optimization graph data
getGoalAIOptimizationActivitiesGet Goal-AI optimization activities for a campaignGet campaign AI-Based Optimization activity
getGoalAIOptimizationActivitiesDownloadDownload Goal-AI optimization activities for a campaign

Dashboard management​

Tool nameDescriptionDocumentation
createDashboardAPICreate a new dashboardCreate dashboard
updateDashboardAPIUpdate an existing dashboardUpdate dashboard
deleteDashboardAPIDelete a dashboardDelete dashboard

Dashboard reports​

Tool nameDescriptionDocumentation
v4-dashboard-get-report-by-workspaceGet a campaign performance report grouped by workspaceWorkspace report
dashboard-report-by-workspace-downloadDownload a campaign performance report grouped by workspace
v4-dashboard-report-by-ioGet a campaign performance report grouped by insertion orderIO report
v4-dashboard-report-by-io-downloadDownload a campaign performance report grouped by insertion order
v4-dashboard-get-report-by-exchangeGet a campaign performance report grouped by exchangeExchange report
v4-dashboard-download-report-by-exchangeDownload a campaign performance report grouped by exchange
v4-dashboard-get-report-by-customerGet a campaign performance report grouped by customer/advertiserCustomer report
dashboard-report-by-customer-downloadDownload a campaign performance report grouped by customer/advertiser
dashboard-report-by-campaign-v2Get a campaign performance report grouped by campaignCampaign report
dashboard-report-by-campaign-downloadDownload a campaign performance report grouped by campaign
dashboard-report-metrics-timelineGet campaign performance metrics over timeMetrics timeline
dashboard-report-metrics-comparisonCompare aggregated campaign metrics between two periodsMetrics comparison

CampaignPulse​

Tool nameDescriptionDocumentation
campaignPulseDetailsGet CampaignPulse diagnosis resultsGet CampaignPulse diagnosis results
campaignPulseSeverityDetailsGet CampaignPulse severity check countsGet CampaignPulse severity counts
dashboard-campaign-pulse-categoriesGet the list of CampaignPulse categoriesGet CampaignPulse categories
dashboard-campaign-pulse-run-singleRun CampaignPulse now for a single campaignRun CampaignPulse now
run-campaign-pulse-severity-checkRun a CampaignPulse severity check nowRun CampaignPulse severity check now

Master API​

The Master API provides static and segment lookup data -- geographic, demographic, device, creative, and inventory reference lists -- used to populate targeting options across the platform. See the Master API guidelines for more information.

Geographic segments​

Tool nameDescriptionDocumentation
getMasterSegmentZipCodeGet ZIP codes with associated state IDsGet ZIP codes and state IDs
getStatesSegmentDetailsGet the state segment listGet state segment
getMasterSegmentStateGet the state segment list (legacy endpoint)
getCountySegmentDetailsGet the county segment listGet county segment
getMasterSegmentCountyGet the county segment list (legacy endpoint)
getCountrySegmentDetailsGet the country segment listGet country segment
getMasterSegmentCountryGet the country segment list (legacy endpoint)
getCitySegmentDetailsGet the city segment listGet city segment
getMasterSegmentCityGet the city segment list (legacy endpoint)
getMasterSegmentLocationTypesGet available location type filtersGet location types
getMasterSegmentLocationTypeDetailsGet location details filtered by location typeGet location details by location type

Political and regional segments​

Tool nameDescriptionDocumentation
getSenateDistrictSegmentDetailsGet the senate district segment listGet senate district segment
getMasterSegmentSenateDistrictGet the senate district segment list (legacy endpoint)
getHouseDistrictSegmentDetailsGet the house district segment listGet house district segment
getMasterSegmentHouseDistrictGet the house district segment list (legacy endpoint)
getCongressionalDistrictSegmentDetailsGet the congressional district segment listGet congressional district segment
getMasterSegmentCongressionalDistrictGet the congressional district segment list (legacy endpoint)
getDistrictsByStatesGet districts filtered by state (legacy endpoint)
getDMACodeDetailsGet the DMA code segment listGet DMA code segment
DMA-CodesGet the DMA code list (legacy endpoint)
CarriersByCountryGet carriers by country IDGet carriers and states by country ID
StatesByCountryGet states by country ID

Demographic segments​

Tool nameDescriptionDocumentation
getGenderSegmentDetailsGet the gender segment listGet gender segment
getMasterSegmentGenderGet the gender segment list (legacy endpoint)
getMasterSegmentAgeGet the age segment listGet age segment
getMasterSegmentLanguageGet the language segment listGet language segment
getMasterSegmentInterestGet the interest segment listGet interest segment
getMasterSegmentIncomeGet the income range segment listGet income range segment
getMasterSegmentEthnicityGet the ethnicity segment listGet ethnicity segment
getMasterSegmentEthnicityGroupGet the ethnicity group segment listGet ethnicity group segment

Device and technology segments​

Tool nameDescriptionDocumentation
DeviceTypesGet device types for targeting (legacy endpoint)
getMasterSegmentDeviceTypeGet the device type segment list (legacy endpoint)
getDeviceSegmentTypeGet the device type segment listGet device type
NetworkTypesGet network types for targetingGet network types for targeting
Device-OSGet device OS options for targetingGet device OS for targeting
getMasterSegmentOSGet the device OS segment list
ManufacturersGet device manufacturers for targeting (legacy endpoint)
getMasterSegmentDeviceManufactureGet the device manufacturer segment listGet manufacturers for targeting
getMasterSegmentDeviceCarrierGet the device carrier segment list
getMasterSegmentConnectionTypeGet the connection type segment list

Creative and video targeting​

Tool nameDescriptionDocumentation
GetSegmentCreativeSizesGet creative dimensions, player sizes, and durations (legacy endpoint)
getCreativeSizesGet creative dimensions, player sizes, and durationsGet creative sizes
getCreativeRTBTypesGet RTB creative typesGet RTB creative types
getVideoTargetingSkippabilityGet video skippability parameter segmentsGet video skip parameters
getVideoTargetingRollPositionGet video roll-position parameter segmentsGet video roll position parameters
getVideoTargetingPlayerSizeGet video player-size parameter segmentsGet video player size parameters
getVideoTargetingPlaybackMethodGet video playback-method parameter segmentsGet video playback method parameters
getVideoTargetingPlacementTypesGet video placement-type parameter segmentsGet video placement type parameters

Inventory and campaign statics​

Tool nameDescriptionDocumentation
AdCategoriesGet publisher ad categories (legacy endpoint)
getPublisherAdCategoriesDetailsGet the publisher ad category listGet publisher ad categories
TimezonesGet timezones for targeting (legacy endpoint)
getTimezonesGet the timezone listGet timezones
Traffic-Types-SourceGet source traffic types for targeting (legacy endpoint)
getTrafficTypesGet traffic (channel) types for the inventory appGet traffic types
GetInventoryTypesGet inventory types (legacy endpoint)
getInventoryTypesGet the inventory type listGet inventory types
getInventoryDetailsGet the inventory listGet inventory
getMasterSegmentChannelGet the channel list for inventoryGet channels for inventory
getExchangesGet the exchange listGet exchanges
getDealCurationTypesGet the deal curation type listGet deal curation types

Planner API​

The Planner API allows you to draft ad strategy proposals and plans, including Political and Healthcare Professional (HCP) Planner workflows, and generate insertion orders and campaigns from them. See the Planner API guidelines for more information.

Proposal details and summaries​

Tool nameDescriptionDocumentation
getProposalDetailsByIdGet full details of a proposal by IDGet proposal details by ID
proposalDetailListGet a searchable, sortable list of proposalsGet list of proposals
getReachAndImpressionsGet maximum reach and impressions for a proposal's targetingProposal reach and impressions summary
getDeviceTypeDataGet impression distribution by device type for a proposalProposal device type summary
getChannelTypeDataGet impression distribution by channel type for a proposalProposal channel type summary
getBidLandscapeDataGet bid landscape data (CPM and impressions by percentile) for a proposalProposal bid landscape summary
generateS3LinkForDownloadProposalGet a signed download link for a proposal reportDownload proposal

Proposal management​

Tool nameDescriptionDocumentation
createProposalCreate a proposal in ready stateCreate proposal
addDraftProposalCreate a proposal in draft stateCreate draft proposal
editReadyProposalUpdate a ready (or failed) proposalUpdate proposal
updateDraftProposalUpdate a draft proposalUpdate draft proposal
generateIOCampaignsGenerate the insertion order and campaigns for a ready proposalGenerate campaigns for ready proposal
restoreReadyProposalRestore an expired proposal with new flight datesRestore proposal
createDuplicateProposalDuplicate an existing proposalDuplicate proposal
softDeleteProposalDelete a proposalDelete proposal

Proposal static lookups​

Tool nameDescriptionDocumentation
ProposalStatusListGet the list of proposal statusesProposal status list
getSupportedParametersGet supported parameters for the proposal summaryProposal summary parameters list
getDefaultCustomerMarginGet the logged-in user's access to parent organizationsGet user access details
getPlanCountByTypeGet the count of plans grouped by plan type

Cross-screen Planner​

Tool nameDescriptionDocumentation
getCrossScreenGraphGet the cross-screen reach saturation graph (venn and line, linear + CTV)Get reach saturation graph
splitProposalSplit a cross-screen proposal's CTV campaigns by device or creativeSplit proposal
getDemographicsKeyDataGet active demographics segment definitions for audience mappingGet demographics keys

Political Planner details​

Tool nameDescriptionDocumentation
getPlanDetailsByIdGet full details of a political plan by IDGet plan details by ID
generateS3LinkForDownloadPoliticalPlanGet a signed download link for a political plan reportDownload plan
getPoliticalPlannerListingGet a searchable, sortable list of political plansGet list of Political plans
getPoliticalProposalListingGet a searchable, sortable list of political proposalsGet list of proposals
getProposalDetailsById_1Get full details of a political proposal by IDGet proposal details
generateS3LinkForDownloadPoliticalProposalGet a signed download link for a political proposal reportDownload proposal
getProposalSummaryGet reach, bid landscape, device, and channel data for a proposalGet proposal summary
getPoliticalStrategyListingGet the list of strategies for a planGet list of strategies
getStrategyByIdGet details of a single strategy by IDGet strategy details

Political plan management​

Tool nameDescriptionDocumentation
createReadyPlanCreate a political plan in ready stateCreate plan
createDraftPlanCreate a political plan in draft state
editPlanUpdate an existing political planEdit plan
editDraftPlanUpdate an existing political draft plan
editPlan_1Rename an existing political planEdit plan name
deletePlansByIdsDelete political plans by ID (bulk)Delete plans
estimatePlanReachEstimate reach for a political planEstimate plan reach
generateCustomStrategiesGenerate custom strategies for an existing planGenerate custom strategies
deleteStrategyByIdDelete a strategy by IDDelete strategy

Political proposal management​

Tool nameDescriptionDocumentation
activateProposalActivate a proposal and its proposed campaignsActivate proposal
editProposalUpdate a political proposal's details and campaignsEdit proposal
editProposal_2Rename an existing political proposalEdit proposal name
generateIOCampaigns_1Generate the insertion order and campaigns from a political proposalGenerate IO and campaigns
deleteProposalsByIdsDelete political proposals by ID (bulk)Delete proposals
restoreProposalsRestore expired political proposals back to ready statusRestore proposals
createCvaDetailsCreate Custom Voter Audience (CVA) detailsCreate CVA details
updateCvaDetailsUpdate Custom Voter Audience (CVA) detailsUpdate CVA details

Political Planner static lookups​

Tool nameDescriptionDocumentation
getSupportedParamsGet supported parameters for political plan configurationGet supported parameters
getTargetingTypesGet available targeting typesGet targeting types
getStrategyTypesGet available strategy typesGet strategy types
getSplitTypesGet available split typesGet split types
getPlanStatusesGet available plan status typesGet plan statuses
getPlanObjectiveTypesGet available plan objective typesGet plan objectives

HCP Planner details​

Tool nameDescriptionDocumentation
getHcpPlanByIdGet full details of an HCP plan by IDHCP Planner details by ID
hcpPlannerListingGet a searchable, sortable list of HCP plannersGet list of HCP Planners
accountsListGet a searchable list of accountsGet list of accounts
downloadPlanGet a signed download link for an HCP planDownload HCP Planner

HCP Planner management​

Tool nameDescriptionDocumentation
addDraftProposal_1Create an HCP planner proposal in draft stateCreate HCP Planner
createProposal_1Create an HCP planner proposal in ready state
editProposal_1Update an existing HCP planner proposalUpdate HCP Planner
deleteProposalsDelete HCP planner proposalsDelete HCP Planner
validatePlannerNameCheck whether an HCP planner name is availableValidate Planner name
getTargetingGraphsGet targeting graphs for an HCP plannerGet targeting graphs
getAudienceGraphGet the audience graph for an HCP plannerGet audience graph
getAudienceSummaryGet aggregated audience reach summary for an HCP plannerGet audience summary
generateHCPProposedCampaignsGenerate proposed campaigns split by strategy for an HCP planGenerate campaigns plan
generateIOCampaigns_2Publish draft campaigns for an HCP planPublish campaigns plan

NPI file and audience generation​

Tool nameDescriptionDocumentation
uploadNpiListUpload an NPI list (CSV/XLSX) for HCP targeting
getGeneratedAudiencesGenerate candidate audiences for an HCP planner
softDeleteNpiFileDelete an uploaded NPI file

HCP Planner static lookups​

Tool nameDescriptionDocumentation
getSplitStrategiesForHcpPlannerGet available split strategiesGet split strategy list
getNpiTypesListGet available NPI typesNPI type list
getGeographySegmentsGet available geography segmentsGet geography segments
getDataPartnersForHcpPlannerGet available data partnersGet data partners list
getAudienceSelectionMethodsGet available audience selection methodsGet audience selection methods list
specialitiesListGet a searchable list of specialtiesGet specialties list
accountTypesListGet a searchable list of account typesGet account types
Have a question?
Was this page helpful?