# Campaigns API MediaMath Platform API Version: xx.xx.xx ## Servers Live Server ``` https://api.mediamath.com/api/v3.0 ``` ## Security ### Auth0 Type: oauth2 ## Download OpenAPI description [Campaigns API](https://apidocs.mediamath.com/_bundle/apis/campaigns-api/openapi.yaml) ## Organizations Organizations ### List Organizations - [GET /organizations](https://apidocs.mediamath.com/apis/campaigns-api/openapi/organizations/list-organizations.md): Get a list of organizations ### Create an Organization - [POST /organizations](https://apidocs.mediamath.com/apis/campaigns-api/openapi/organizations/create-organization.md): Create an organization ### Get an Organization - [GET /organizations/{organization_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/organizations/get-organization.md): Get an organization by ID ### Update an Organization - [POST /organizations/{organization_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/organizations/update-organization.md): Update an organization by ID ### Organization Audit Log - [GET /organizations/{organization_id}/history](https://apidocs.mediamath.com/apis/campaigns-api/openapi/organizations/organization-audit-log.md): Get a list of changes to this organization ### Bulk Organization Audit Log - [POST /audit_log/organizations](https://apidocs.mediamath.com/apis/campaigns-api/openapi/organizations/organization-audit-log-bulk.md): Get a list of changes to these organizations ### List User Permissions for an Organization - [GET /organizations/{organization_id}/permissions](https://apidocs.mediamath.com/apis/campaigns-api/openapi/organizations/list-user-permissions-organization.md): List user permissions for an organization ### List Settings for an Organization - [GET /organizations/{organization_id}/settings](https://apidocs.mediamath.com/apis/campaigns-api/openapi/organizations/list-settings-organization.md): List settings for an organization ### Update Settings for an Organization - [POST /organizations/{organization_id}/settings](https://apidocs.mediamath.com/apis/campaigns-api/openapi/organizations/update-settings-organization.md): Update settings for an organization ## Agencies Agencies ### List Agencies - [GET /agencies](https://apidocs.mediamath.com/apis/campaigns-api/openapi/agencies/list-agencies.md): Get a list of agencies ### Create an Agency - [POST /agencies](https://apidocs.mediamath.com/apis/campaigns-api/openapi/agencies/create-agency.md): Create an agency ### Get an Agency - [GET /agencies/{agency_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/agencies/get-agency.md): Get an agency by ID ### Update an Agency - [POST /agencies/{agency_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/agencies/update-agency.md): Update an agency by ID ### Agency Audit Log - [GET /agencies/{agency_id}/history](https://apidocs.mediamath.com/apis/campaigns-api/openapi/agencies/agency-audit-log.md): Get a list of changes to this agency ### List User Permissions for an Agency - [GET /agencies/{agency_id}/permissions](https://apidocs.mediamath.com/apis/campaigns-api/openapi/agencies/list-user-permissions-agency.md): List user permissions for an agency ### Bulk Agency Audit Log - [POST /audit_log/agencies](https://apidocs.mediamath.com/apis/campaigns-api/openapi/agencies/agency-audit-log-bulk.md): Get a list of changes to these agencies ## Advertisers Advertisers ### List Advertisers - [GET /advertisers](https://apidocs.mediamath.com/apis/campaigns-api/openapi/advertisers/list-advertisers.md): Get a list of advertisers ### Create an Advertiser - [POST /advertisers](https://apidocs.mediamath.com/apis/campaigns-api/openapi/advertisers/create-advertiser.md): Create an advertiser ### Get an Advertiser - [GET /advertisers/{advertiser_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/advertisers/get-advertiser.md): Get an advertiser by ID ### Update an Advertiser - [POST /advertisers/{advertiser_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/advertisers/update-advertiser.md): Update an advertiser by ID ### Advertiser Audit Log - [GET /advertisers/{advertiser_id}/history](https://apidocs.mediamath.com/apis/campaigns-api/openapi/advertisers/advertiser-audit-log.md): Get a list changes to this advertiser ### List Advertisers when Agency has Cross Advertiser Pixels enabled - [GET /advertisers/{advertiser_id}/pixel_targeting_advertisers](https://apidocs.mediamath.com/apis/campaigns-api/openapi/advertisers/list-advertisers-pixel-x-advertisers.md): List all advertiser siblings when parent agency has allow_x_adv_pixels set to true ### List User Permissions for an Advertiser - [GET /advertisers/{advertiser_id}/permissions](https://apidocs.mediamath.com/apis/campaigns-api/openapi/advertisers/list-user-permissions-advertiser.md): List user permissions for an advertiser ### Bulk Advertiser Audit Log - [POST /audit_log/advertisers](https://apidocs.mediamath.com/apis/campaigns-api/openapi/advertisers/advertiser-audit-log-bulk.md): Get a list of changes to these advertiser ## Campaigns Campaigns ### Bulk Update Campaigns - [POST /bulk_update/campaigns](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaigns/bulk-update-campaigns.md): Update multiple campaigns ### Get a Specific Campaign - [GET /campaigns/{campaign_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaigns/get-campaign.md): Get a campaign by ID ### Update a Campaign - [POST /campaigns/{campaign_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaigns/update-campaign.md): Update a campaign by ID ### List Campaigns - [GET /campaigns](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaigns/list-campaigns.md): Get a list of campaigns. The data fetched for each campaign depends on the values of query params. For example, if you use query parameter full all properties are fetched. ### Create a Campaign - [POST /campaigns](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaigns/create-campaign.md): Create a campaign ### Campaign Audit Log - [GET /campaigns/{campaign_id}/history](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaigns/campaign-audit-log.md): Get a list of changes made to this campaign ### (Legacy) Update Specific Campaign Dynamic Budget Allocation - [POST /campaigns/{campaign_id}/dynamic_budget_allocation](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaigns/update-dba-single-legacy.md): Legacy Endpoint - To be removed ### Copy a Campaign - [POST /campaigns/{campaign_id}/copy](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaigns/copy-campaign.md): Copy a campaign ### Update Campaign Dynamic Budget Allocation - [POST /campaign_dba](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaigns/update-dba.md): This end point is restricted to a specific service account ### List User Permissions for a Campaign - [GET /campaigns/{campaign_id}/permissions](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaigns/list-user-permissions-campaign.md): List user permissions for an campaign ### Bulk Campaign Audit Log - [POST /audit_log/campaigns](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaigns/campaign-audit-log-bulk.md): Get a list of changes to these campaigns ## Campaigns Budget Flights Campaigns Budget Flights ### Bulk Update Budget Flights - [POST /bulk_update/budget_flights](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaigns-budget-flights/bulk-update-budget-flights.md): Update multiple budget flights ### List Budget Flights - [GET /campaigns/{campaign_id}/budget_flights](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaigns-budget-flights/list-budget-flights.md): Get a list of budget flights ### Budget Flights for a given Campaign Audit Log - [GET /campaigns/{campaign_id}/budget_flights/history](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaigns-budget-flights/campaign-budget-flights-audit-log.md): Get a list changes to this campaign's budget flights ## Campaign Plans Campaign Plans ### List Campaign Plans - [GET /campaign_plans](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaign-plans/list-campaign-plans.md): Get a list of campaign plans ### Create Campaign Plan - [POST /campaign_plans](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaign-plans/create-campaign-plan.md): Create a campaign plan ### Get a Campaign Plan - [GET /campaign_plans/{campaign_plan_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaign-plans/get-campaign-plan.md): Get a campaign plan by ID ### Update a Campaign Plan - [POST /campaign_plans/{campaign_plan_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaign-plans/update-campaign-plan.md): Update a campaign plan by ID ## Strategies Strategies ### Create a Strategy - [POST /strategies](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategies/create-strategy.md): Create a strategy. If your use case requires more than 100,000 IPs or postal codes, please contact your MediaMath representative to discuss custom solutions or alternative approaches. ### List Strategies - [GET /strategies](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategies/list-strategies.md): Get a list of strategies ### Update a Strategy - [POST /strategies/{strategy_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategies/update-strategy.md): Update a strategy by ID. If your use case requires more than 100,000 IPs or postal codes, please contact your MediaMath representative to discuss custom solutions or alternative approaches. ### Get a Strategy - [GET /strategies/{strategy_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategies/get-strategy.md): Get a strategy by ID ### Copy a strategy - [POST /strategies/{strategy_id}/copy](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategies/post-copy-strategy.md): Copy a strategy ### Get Targeting Friendly Names - [GET /strategies/{strategy_id}/friendly_names](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategies/get-strategy-friendly-names.md): Get targeting friendly names ### Get Forecast Query - [GET /strategies/{strategy_id}/forecast_query](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategies/get-strategy-forecast-query.md): Get forecast query ### Get Targeting Expression - [GET /strategies/{strategy_id}/targeting_expression](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategies/get-strategy-targeting-expression.md): Get the normalized targeting expression for a strategy. ### Strategy Audit Log - [GET /strategies/{strategy_id}/history](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategies/strategy-audit-log.md): Get a list changes to this strategy ### Bulk Update Strategies - [POST /bulk_update/strategies](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategies/bulk-update-strategies.md): Update multiple strategies ### List User Permissions for a Strategy - [GET /strategies/{strategy_id}/permissions](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategies/list-user-permissions-strategy.md): List user permissions for a strategy ### Bulk Strategy Audit Log - [POST /audit_log/strategies](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategies/strategy-audit-log-bulk.md): Get a list of changes to these strategies ## Strategy Parameters Strategy Parameters ### List Strategy Deals - [GET /strategy_deals](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategy-parameters/list-strategy-deals.md): Get a list of strategy deals ### List Strategy Day Parts - [GET /strategy_day_parts](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategy-parameters/list-strategy-day-parts.md): Get a list of strategy day parts ### List Strategy Groups - [GET /strategy_groups](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategy-parameters/list-strategy-groups.md): Get a list of strategy groups for a specific campaign ### List Strategy IP Addresses - [GET /strategy_ip_addresses](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategy-parameters/list-strategy-ip-addresses.md): Get a list of strategy IP addresses with default sort by id DESC. Can be queried by: - id, - version, - target_inet with type IP/CIDR for all operators except search =:, - strategy_id is required, - created_on, - updated_on and can be sorted by: - id, - version, - target_inet, - strategy_id, - created_on, - updated_on. ### Download Information for a Strategy IP addresses - [GET /strategy_ip_addresses/{strategy_id}/download.csv](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategy-parameters/download-strategy-ip-addresses.md): CSV download of IP addresses for a strategy ### List Strategy Concepts - [GET /strategy_concepts](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategy-parameters/list-strategy-concepts.md): Get a list of strategy concepts ### List Strategy Target Values - [GET /strategy_target_values](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategy-parameters/list-strategy-target-values.md): Get a list of strategy target values ### Download Information for a Strategy Postal Codes - [GET /strategy_postal_codes/{strategy_id}/download.csv](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategy-parameters/download-strategy-postal-codes.md): CSV download of postal codes for a strategy ## Strategy Templates Strategy Templates ### Create a Strategy Template - [POST /strategy_templates](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategy-templates/create-strategy-template.md): Create a strategy template ### List Strategy Templates - [GET /strategy_templates](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategy-templates/list-strategy-template.md): Get a list of strategy templates ### Update a Strategy Template - [POST /strategy_templates/{strategy_template_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategy-templates/update-strategy-template.md): Update a strategy template by ID ### Get a Strategy Template - [GET /strategy_templates/{strategy_template_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategy-templates/get-strategy-template.md): Get a strategy template by ID ### Delete a Strategy Template - [DELETE /strategy_templates/{strategy_template_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategy-templates/delete-strategy-template.md): Delete a strategy template by ID ## New Strategy Plans New Strategy Plans ### Post Ephemeral New Strategy Plan to Run a Forecast - [POST /new_strategy_plans/forecast](https://apidocs.mediamath.com/apis/campaigns-api/openapi/new-strategy-plans/post-ephemeral-new-strategy-plan.md): Post a new strategy plan object to run forecast without saving the strategy plan ### Run and Update Forecast for Given New Strategy Plan - [POST /new_strategy_plans/{strategy_plan_id}/forecast](https://apidocs.mediamath.com/apis/campaigns-api/openapi/new-strategy-plans/run-and-update-forecast.md): Run and update forecast for given new strategy plan ID ### Get a New Strategy Plan - [GET /new_strategy_plans/{strategy_plan_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/new-strategy-plans/get-new-strategy-plan.md): Get a new strategy plan by ID ### Update a New Strategy Plan - [POST /new_strategy_plans/{strategy_plan_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/new-strategy-plans/update-new-strategy-plan.md): Update a new strategy plan by ID ### Delete a New Strategy Plan - [DELETE /new_strategy_plans/{strategy_plan_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/new-strategy-plans/delete-new-strategy-plan.md): Delete a new strategy plan by ID ### List New Strategy Plans - [GET /new_strategy_plans](https://apidocs.mediamath.com/apis/campaigns-api/openapi/new-strategy-plans/list-new-strategy-plans.md): Get a list of new strategy plans ### Create a New Strategy Plan - [POST /new_strategy_plans](https://apidocs.mediamath.com/apis/campaigns-api/openapi/new-strategy-plans/create-new-strategy-plan.md): Create a new strategy plan ### List New Strategy Plan Target Values - [GET /new_strategy_plan_target_values](https://apidocs.mediamath.com/apis/campaigns-api/openapi/new-strategy-plans/list-new-strategy-plan-target-values.md): Get a list of new strategy plan target values ## Targeting Targeting ### (Legacy) List Targets - [GET /target](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/list-targets-legacy.md): Get a list of targets ### (Legacy) Create a Target - [POST /target](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/create-target-legacy.md): Create a target ### (Legacy) Get a Target - [GET /target/{target_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/get-target-legacy.md): Get a target by ID ### (Legacy) Update a Target - [POST /target/{target_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/update-target-legacy.md): Update a target by ID ### (Legacy) Delete a Target - [DELETE /target/{target_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/delete-target-legacy.md): Delete a target by ID ### (Legacy) Update a Target - [PUT /target/{target_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/put-update-target-legacy.md): Update a target by ID ### List targets - [GET /targets](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/list-targets.md): Get a list of targets ### Create a Target - [POST /targets](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/create-target.md): Create a target ### Get a Target - [GET /targets/{target_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/get-target.md): Get a target by ID ### Update a Target - [POST /targets/{target_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/update-target.md): Update a target by ID ### Delete a Target - [DELETE /targets/{target_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/delete-target.md): Delete a target by ID ### List Target paths - [GET /target-path](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/list-target-paths-legacy.md): Get a list of target paths ### Add and View Targeting - [POST /targeting](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/add-view-targeting.md): Add and view targeting ### Contextual Segments CPM estimates - [POST /contextual_segments/cpm_estimate](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/contextual-segments-cpm-estimate.md): Get CPM estimates for contextual segments ### Get Frequently Used Contextual Segments - [GET /targeting_segments/frequently_used](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/get-targeting-segments-frequently-used.md): Display the most frequently used contextual segments for a given advertiser ### Frequently Used Audience Segments - [GET /audience_segments/frequently_used](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/get-audience-segments-frequently-used.md): Display the most frequently used audience segments for a given advertiser or campaign. ### Audience Segments CPM Estimate - [POST /audience_segments/cpm_estimate](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/audience-segments-cpm-estimate.md): Audience segments CPM estimate ### List Technology Target Values - [GET /technology_target_values](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/list-technology-target-values.md): Get list of technology target values. Can be sorted by: - id, - dimension, - parent_id, - name, - full_path, - value, - code, - sortable_name and queried (with q=) by: - id, - parent_id, - name, - full_path (if provided parameter full_path will be ignored), - value, - code, - sortable_name. ### List Contextual Segments - [GET /path_targeting_segments](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/list-contextual-segments.md): Get a list of contextual segments ### List Path Audience Segments - [GET /path_audience_segments](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/list-path-audience-segments.md): Get a list of path audience segments. Segments can be queried and sorted by fields: - id, - name, - version, - parent_audience_segment_id, - full_path, - uniques, - retail_cpm (type = double, value in usd), - code, - buyable, - child_count, - wholesale_cpm (type = double, value in usd), - type, - taxonomy_id, - updated_on, - created_on, - audience_vendor_id, - audience_vendor_name, - audience_vendor_vendor_id, - audience_vendor_mma_free_cm, - audience_vendor_updated_on, - audience_vendor_created_on, - audience_vendor_version, - audience_vendor_provides_batch_segments, - audience_vendor_campaign_brain_enabled, - audience_vendor_pin_top_search, - audience_vendor_bidder_code, - audience_vendor_namespace_code. ## Targeting Attachments TargetingAttachments ### Get a List of Attachments - [GET /attachments](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-attachments/list-attachments.md): Get a list of attachments. Attachments can be queried and sorted by fields: - id, - target_id, - strategy_id, - restriction, - operator, - created_on, - updated_on, - version, - or_better. ### Create an Attachment - [POST /attachments](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-attachments/create-attachment.md): Create an attachment ### (Legacy) Get a List of Attachments - [GET /attachment](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-attachments/list-attachments-legacy.md): Get a list of attachments ### (Legacy) Create an Attachment - [POST /attachment](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-attachments/create-attachment-legacy.md): Create an attachment ### Get an Attachment - [GET /attachments/{attachment_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-attachments/get-attachment.md): Get an attachment by ID ### Update an Attachment - [POST /attachments/{attachment_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-attachments/update-attachment.md): Update an attachment by ID ### Delete an Attachment - [DELETE /attachments/{attachment_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-attachments/delete-attachment.md): Delete an attachment by ID ### (Legacy) Get an Attachment - [GET /attachment/{attachment_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-attachments/get-attachment-legacy.md): Get an attachment by ID ### (Legacy) Update an Attachment - [PUT /attachment/{attachment_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-attachments/update-attachment-legacy.md): Update an attachment by ID ### (Legacy) Delete an Attachment - [DELETE /attachment/{attachment_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-attachments/delete-attachment-legacy.md): Delete an attachment by ID ## Targeting Segments Targeting Segments ### List Targeting Segments - [GET /targeting_segments](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-segments/list-targeting-segments.md): Get a list of targeting segments ## Targeting Segment Objectives Targeting Segment Objectives ### List Targeting Segment Objectives - [GET /targeting_segment_objectives](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-segment-objectives/list-targeting-segment-objectives.md): Get a list of targeting segment objectives ### Get a Targeting Segment Objective - [GET /targeting_segment_objectives/{objective_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-segment-objectives/get-targeting-segment-objective.md): Get a targeting segment objective by ID ## Vendor Contracts Vendor Contracts ### List Vendor Contracts - [GET /vendor_contracts](https://apidocs.mediamath.com/apis/campaigns-api/openapi/vendor-contracts/list-vendor-contracts.md): List vendor contracts ## Contracts Contracts ### Create a Contract - [POST /contracts](https://apidocs.mediamath.com/apis/campaigns-api/openapi/contracts/create-contract.md): Create a contract ### List Contracts - [GET /contracts](https://apidocs.mediamath.com/apis/campaigns-api/openapi/contracts/list-contracts.md): Get a list of contracts ### Update a Contract - [POST /contracts/{contract_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/contracts/update-contract.md): Update a contract by ID ### Get a Contract - [GET /contracts/{contract_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/contracts/get-contract.md): Get a contract by ID ### Contract Audit Log - [GET /contracts/{contract_id}/history](https://apidocs.mediamath.com/apis/campaigns-api/openapi/contracts/contract-audit-log.md): Get a list changes to this contract ## Audience Vendors Audience Vendors ### List Audience Vendors - [GET /audience_vendors](https://apidocs.mediamath.com/apis/campaigns-api/openapi/audience-vendors/list-audience-vendors.md): Get a list of audience vendors ### Create an Audience Vendor - [POST /audience_vendors](https://apidocs.mediamath.com/apis/campaigns-api/openapi/audience-vendors/create-audience-vendor.md): Create an audience vendor ### Get an Audience Vendor - [GET /audience_vendors/{audience_vendor_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/audience-vendors/get-audience-vendor.md): Get an audience vendor by ID ### Update an Audience Vendor - [POST /audience_vendors/{audience_vendor_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/audience-vendors/update-audience-vendor.md): Update an audience vendor by ID ## Vendors Vendors ### List Vendors - [GET /vendors](https://apidocs.mediamath.com/apis/campaigns-api/openapi/vendors/list-vendors.md): Get a list of vendors. The data fetched for each vendor depends on the values of query params. For example, if you use query parameter full all properties are fetched. ### Get a Vendor - [GET /vendors/{vendor_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/vendors/get-vendor.md): Get a vendor by ID ## Atomic Creatives Atomic Creatives ### Preview creative assets before uploading - [POST /creative_draft](https://apidocs.mediamath.com/apis/campaigns-api/openapi/atomic-creatives/paths/~1creative_draft/post.md): This endpoint allows you to preview creative assets before they are permanently uploaded to the system. It validates the files and metadata, returning a preview of what will be created without actually storing the creatives. This is useful for verifying that your files and metadata are correct before committing to the upload. ### Creative assets upload - [POST /creative_upload](https://apidocs.mediamath.com/apis/campaigns-api/openapi/atomic-creatives/paths/~1creative_upload/post.md): Upload creative assets to the system and create atomic creatives. This endpoint processes the uploaded files and metadata, validates them, and stores them permanently in the system. Once uploaded, the creatives can be associated with campaigns and strategies. ### List Atomic Creatives - [GET /atomic_creatives](https://apidocs.mediamath.com/apis/campaigns-api/openapi/atomic-creatives/list-atomic-creatives.md): Get a list of atomic creatives ### Create atomic creative - [POST /atomic_creatives](https://apidocs.mediamath.com/apis/campaigns-api/openapi/atomic-creatives/post-atomic_creatives.md): Create an atomic creative ### Get an Atomic Creative - [GET /atomic_creatives/{atomic_creative_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/atomic-creatives/get-atomic-creative.md): Get an atomic creative by ID ### Update an atomic creative - [POST /atomic_creatives/{atomic_creative_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/atomic-creatives/post-atomic_creatives-atomic_creative_id.md): Update an atomic creative by ID ### Atomic Creative Audit Log - [GET /atomic_creatives/{atomic_creative_id}/history](https://apidocs.mediamath.com/apis/campaigns-api/openapi/atomic-creatives/atomic-creative-audit-log.md): Get a list changes to this atomic creative ### Healthcheck for Atomic Creatives - [GET /atomic_creatives/healthcheck](https://apidocs.mediamath.com/apis/campaigns-api/openapi/atomic-creatives/atomic-creatives-healthcheck.md): Endpoint to check the health of atomic creatives by ID(s). ### Bulk Update Atomic Creatives - [POST /bulk_update/atomic_creatives](https://apidocs.mediamath.com/apis/campaigns-api/openapi/atomic-creatives/bulk-update-atomic-creatives.md): Update multiple atomic creatives ## Concepts Concepts ### List Concepts - [GET /concepts](https://apidocs.mediamath.com/apis/campaigns-api/openapi/concepts/list-concepts.md): Get a list of concepts. Concepts can be sorted by fields: - id, - version, - advertiser_id, - name, - status, - created_on, - updated_on, - advertiser_name and queried by fields: - id, - version, - advertiser_id, - name, - status, - created_on, - updated_on, - advertiser_name, - organization_id, - agency_id. ### Create a Concept - [POST /concepts](https://apidocs.mediamath.com/apis/campaigns-api/openapi/concepts/create-concept.md): Create a concept ### Get a Concept - [GET /concepts/{concept_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/concepts/get-concept.md): Get a concept by ID ### Update a Concept - [POST /concepts/{concept_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/concepts/update-concept.md): Update a concept by ID ### Concepts Audit Log - [GET /concepts/{concept_id}/history](https://apidocs.mediamath.com/apis/campaigns-api/openapi/concepts/concepts-audit-log.md): Get a list changes to this concept ### Bulk Update Concepts - [POST /bulk_update/concepts](https://apidocs.mediamath.com/apis/campaigns-api/openapi/concepts/bulk-update-concepts.md): Update multiple concepts ## Creatives Creatives ### Get a Creative - [GET /creatives/{creative_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/creatives/get-creative.md): Get a creative by ID ## Pixel Bundles Pixel Bundles ### Create a Pixel Bundle - [POST /pixel_bundles](https://apidocs.mediamath.com/apis/campaigns-api/openapi/pixel-bundles/create-pixel-bundle.md): Create a pixel bundle ### List Pixel Bundles - [GET /pixel_bundles](https://apidocs.mediamath.com/apis/campaigns-api/openapi/pixel-bundles/list-pixel-bundles.md): Get a list of pixel bundles ### Update a Pixel Bundle - [POST /pixel_bundles/{pixel_bundle_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/pixel-bundles/update-pixel-bundle.md): Update a pixel bundle by ID ### Get a Pixel Bundle - [GET /pixel_bundles/{pixel_bundle_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/pixel-bundles/get-pixel-bundle.md): Get a pixel bundle by ID ### Pixel Bundle Audit Log - [GET /pixel_bundles/{pixel_bundle_id}/history](https://apidocs.mediamath.com/apis/campaigns-api/openapi/pixel-bundles/pixel-bundle-audit-log.md): Get a list changes to this pixel bundle ## Pixel Providers Pixel Providers ### List Pixel Providers - [GET /pixel_providers](https://apidocs.mediamath.com/apis/campaigns-api/openapi/pixel-providers/list-pixel-providers.md): Get all pixel providers ## Marketplaces Marketplaces ### Get a Marketplace - [GET /marketplaces/{marketplace_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/marketplaces/get-marketplace.md): Get a marketplace by ID ### Update a Marketplace - [POST /marketplaces/{marketplace_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/marketplaces/update-marketplace.md): Update a marketplace by ID ### List Marketplaces - [GET /marketplaces](https://apidocs.mediamath.com/apis/campaigns-api/openapi/marketplaces/list-marketplaces.md): Get a list of marketplaces ### Create a Marketplace - [POST /marketplaces](https://apidocs.mediamath.com/apis/campaigns-api/openapi/marketplaces/create-marketplace.md): Create a marketplace ## Users Users ### List users - [GET /users](https://apidocs.mediamath.com/apis/campaigns-api/openapi/users/list-users.md): Get a list of users ### Create a User - [POST /users](https://apidocs.mediamath.com/apis/campaigns-api/openapi/users/create-user.md): Create a user ### Get a User - [GET /users/{user_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/users/get-user.md): Get a user by ID ### Update a User - [POST /users/{user_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/users/update-user.md): Update a user by ID ### User Audit Log - [GET /users/{user_id}/history](https://apidocs.mediamath.com/apis/campaigns-api/openapi/users/user-audit-log.md): Get a list changes to this user ### Get User's Settings - [GET /users/{user_id}/settings](https://apidocs.mediamath.com/apis/campaigns-api/openapi/users/get-user-settings.md): Get user's settings by ID ### Update User's Settings - [POST /users/{user_id}/settings](https://apidocs.mediamath.com/apis/campaigns-api/openapi/users/update-user-settings.md): Update user's settings by ID ## User Permissions User Permissions ### List User Permissions - [GET /permissions/{user_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/user-permissions/list-user-permissions.md): Get a list of user permissions ### List User Permissions for Entities - [POST /permissions/{user_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/user-permissions/list-user-permissions-filtered.md): Get a list of user permissions for requested entities ### List User Permissions for All Organizations - [GET /permissions/{user_id}/organizations](https://apidocs.mediamath.com/apis/campaigns-api/openapi/user-permissions/list-user-permissions-organizations.md): Get a list of user permissions for organizations ### List User Permissions for All Agencies - [GET /permissions/{user_id}/agencies](https://apidocs.mediamath.com/apis/campaigns-api/openapi/user-permissions/list-user-permissions-agencies.md): Get a list of user permissions for agencies ### List User Permissions for All Advertisers - [GET /permissions/{user_id}/advertisers](https://apidocs.mediamath.com/apis/campaigns-api/openapi/user-permissions/list-user-permissions-advertisers.md): Get a list of user permissions for advertisers ### List User Permissions for All Campaigns - [GET /permissions/{user_id}/campaigns](https://apidocs.mediamath.com/apis/campaigns-api/openapi/user-permissions/list-user-permissions-campaigns.md): Get a list of user permissions for campaigns ### List User Permissions for All Strategies - [GET /permissions/{user_id}/strategies](https://apidocs.mediamath.com/apis/campaigns-api/openapi/user-permissions/list-user-permissions-strategies.md): Get a list of user permissions for strategies ### List User Permissions (V2 Format) - [GET /permissions/{user_id}/v2format](https://apidocs.mediamath.com/apis/campaigns-api/openapi/user-permissions/list-user-permissions-v2.md): Get a list of user permissions in V2 format ### List User Permissions for Entities (V2 Format) - [POST /permissions/{user_id}/v2format](https://apidocs.mediamath.com/apis/campaigns-api/openapi/user-permissions/list-user-permissions-v2-filtered.md): Get a list of user permissions for requested entities in V2 format ## Enterprise Controls Enterprise Controls ### List Entity Groups - [GET /entity_groups](https://apidocs.mediamath.com/apis/campaigns-api/openapi/enterprise-controls/list-entity-groups.md): Get a list of entity groups ### Get an Entity Group - [GET /entity_groups/{entity_group_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/enterprise-controls/get-entity-group.md): Get an entity group by ID ### Get Entity Group Controls by Entity Type - [GET /entity_groups/{entity_group_id}/controls/{entity_type}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/enterprise-controls/get-entity-group-controls-entity-type.md): Get controls of entity group by entity type ### Entity Group Audit Log - [GET /entity_groups/{entity_group_id}/history](https://apidocs.mediamath.com/apis/campaigns-api/openapi/enterprise-controls/entity-group-audit-log.md): Get a list changes to this entity group ## General General ### Health Check - [GET /healthcheck](https://apidocs.mediamath.com/apis/campaigns-api/openapi/general/healthcheck.md): Health endpoint to check availability ### List Roles - [GET /roles](https://apidocs.mediamath.com/apis/campaigns-api/openapi/general/list-roles.md): Get list of roles ### Search Entities - [GET /search](https://apidocs.mediamath.com/apis/campaigns-api/openapi/general/search-entities.md): Search organizations, agencies or advertisers by name ### List Target Values - [GET /target_values](https://apidocs.mediamath.com/apis/campaigns-api/openapi/general/list-target-values.md): Get list of target values ## Currency Rates Currency Rates ### List Currency Rates - [GET /currency_rates](https://apidocs.mediamath.com/apis/campaigns-api/openapi/currency-rates/list-currency-rates.md): Get a list of currency rates ## Site Lists Site Lists ### List Site Lists - [GET /site_lists](https://apidocs.mediamath.com/apis/campaigns-api/openapi/site-lists/list-site-lists.md): Get a list of site lists. Site lists can be sorted and queried by fields: - id, - version, - status, - organization_id, - name, - restriction, - filename, - content_updated_on, - sites_count, - created_on, - updated_on. ### Get Site List - [GET /site_lists/{site_list_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/site-lists/get-site-list.md): Get a site list by ID ### Upload New Site Lists - [POST /site_lists/upload](https://apidocs.mediamath.com/apis/campaigns-api/openapi/site-lists/upload-create-site-lists.md): Upload new site lists ### Upload Updated Site Lists - [POST /site_lists/{site_list_id}/upload](https://apidocs.mediamath.com/apis/campaigns-api/openapi/site-lists/upload-update-site-lists.md): Upload updated site lists ### Download Information for a Site List - [GET /site_lists/{site_list_id}/download.csv](https://apidocs.mediamath.com/apis/campaigns-api/openapi/site-lists/download-site-lists.md): CSV download of site information for a site list ### List Site List Assignments - [GET /site_lists/{site_list_id}/assignments](https://apidocs.mediamath.com/apis/campaigns-api/openapi/site-lists/get-site-list-assignments.md): Get a list of assignments for a site list ## Timezones Timezones ### List Timezones - [GET /timezones](https://apidocs.mediamath.com/apis/campaigns-api/openapi/timezones/list-timezones.md): Get a list of timezones ## Verticals Verticals ### List Verticals - [GET /verticals](https://apidocs.mediamath.com/apis/campaigns-api/openapi/verticals/list-verticals.md): Get all verticals ## Supply Sources Supply Sources ### List Supply Sources - [GET /supply_sources](https://apidocs.mediamath.com/apis/campaigns-api/openapi/supply-sources/list-supply-sources.md): Get a list of Supply Sources. The data fetched for each Supply Source depends on the values of query params. For example, if you use query parameter full=*; all properties are fetched. ### Get a Supply Source - [GET /supply_sources/{supply_source_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/supply-sources/get-supply-source.md): Get a supply source by ID ## Ad Servers Ad Servers ### List Ad Servers - [GET /ad_servers](https://apidocs.mediamath.com/apis/campaigns-api/openapi/ad-servers/list-ad-servers.md): Get a list of ad servers ## Segment Groups Segment Groups ### Create a Segment Group - [POST /segment_groups](https://apidocs.mediamath.com/apis/campaigns-api/openapi/segment-groups/create-segment-group.md): Create a segment group ### List Segment Groups - [GET /segment_groups](https://apidocs.mediamath.com/apis/campaigns-api/openapi/segment-groups/list-segment-groups.md): Get a list of segment groups ### Update a Segment Group - [POST /segment_groups/{segment_group_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/segment-groups/update-segment-group.md): Update a segment group by ID ### Get a Segment Group - [GET /segment_groups/{segment_group_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/segment-groups/get-segment-group.md): Get a segment group by ID ### Segment Groups Audit Log - [GET /segment_groups/{segment_group_id}/history](https://apidocs.mediamath.com/apis/campaigns-api/openapi/segment-groups/segment-groups-audit-log.md): Get a list of changes to this segment group ### Get Segment Group Assignments - [GET /segment_groups/{segment_group_id}/assignments](https://apidocs.mediamath.com/apis/campaigns-api/openapi/segment-groups/get-segment-group-assignments.md): Get all assignments for a specific segment group