# Campaigns API MediaMath Campaign Management API [Postman Collection](https://apidocs.mediamath.com/guides/postman-collections) Version: 3.0.1807 ## Servers Live Server ``` https://api.mediamath.com/api/v3.0 ``` ## Security ### Auth0 Type: oauth2 Authorization URL: https://auth.mediamath.com/authorize Token URL: https://auth.mediamath.com/oauth/token Scopes: - `offline_access`: for refresh tokens - `manage:services`: normal access ## Download OpenAPI description - [Campaigns API](https://apidocs.mediamath.com/_bundle/apis/campaigns-api/openapi.yaml) ## Advertisers - [GET /advertisers](https://apidocs.mediamath.com/apis/campaigns-api/openapi/advertisers/list-advertisers.md): Get a list of advertisers - [POST /advertisers](https://apidocs.mediamath.com/apis/campaigns-api/openapi/advertisers/create-advertiser.md): Create an advertiser - [GET /advertisers/{advertiser_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/advertisers/get-advertiser.md): Get an advertiser by ID - [POST /advertisers/{advertiser_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/advertisers/update-advertiser.md): Update an advertiser by ID - [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 - [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 - [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 - [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 ## Agencies - [GET /agencies](https://apidocs.mediamath.com/apis/campaigns-api/openapi/agencies/list-agencies.md): Get a list of agencies - [POST /agencies](https://apidocs.mediamath.com/apis/campaigns-api/openapi/agencies/create-agency.md): Create an agency - [GET /agencies/{agency_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/agencies/get-agency.md): Get an agency by ID - [POST /agencies/{agency_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/agencies/update-agency.md): Update an agency by ID - [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 - [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 - [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 ## 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 - [POST /campaign_plans](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaign-plans/create-campaign-plan.md): Create 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 - [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 ## Campaigns - [POST /bulk_update/campaigns](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaigns/bulk-update-campaigns.md): Update multiple campaigns - [GET /campaigns/{campaign_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaigns/get-campaign.md): Get a campaign by ID - [POST /campaigns/{campaign_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaigns/update-campaign.md): Update a campaign by ID - [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. - [POST /campaigns](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaigns/create-campaign.md): Create a campaign - [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 - [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 - [POST /campaigns/{campaign_id}/copy](https://apidocs.mediamath.com/apis/campaigns-api/openapi/campaigns/copy-campaign.md): Copy a campaign - [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 - [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 - [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 - [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 - [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 - [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 ## New Strategy Plans - [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 - [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 - [POST /new_strategy_plans/{strategy_plan_id}/copy](https://apidocs.mediamath.com/apis/campaigns-api/openapi/new-strategy-plans/copy-new-strategy-plan.md): Create a duplicate of an existing strategy plan (and its parent campaign plan). No request body is accepted; the copy is named after the source with a " Copy" suffix and its forecast results are reset - [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 - [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 /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 - [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 - [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 - [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 ## Organizations - [GET /organizations](https://apidocs.mediamath.com/apis/campaigns-api/openapi/organizations/list-organizations.md): Get a list of organizations - [POST /organizations](https://apidocs.mediamath.com/apis/campaigns-api/openapi/organizations/create-organization.md): Create an organization - [GET /organizations/{organization_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/organizations/get-organization.md): Get an organization by ID - [POST /organizations/{organization_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/organizations/update-organization.md): Update an organization by ID - [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 - [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 - [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 - [GET /organizations/{organization_id}/settings](https://apidocs.mediamath.com/apis/campaigns-api/openapi/organizations/list-settings-organization.md): List 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 ## Strategies - [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. - [GET /strategies](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategies/list-strategies.md): Get a list of strategies - [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 /strategies/{strategy_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategies/get-strategy.md): Get a strategy by ID - [POST /strategies/{strategy_id}/copy](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategies/post-copy-strategy.md): Copy a strategy - [GET /strategies/{strategy_id}/healthcheck](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategies/get-strategy-healthcheck.md): Get strategy health - [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 /strategies/{strategy_id}/forecast_query](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategies/get-strategy-forecast-query.md): Get forecast query - [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. - [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 - [POST /bulk_update/strategies](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategies/bulk-update-strategies.md): Update multiple strategies - [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 - [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 - [GET /strategy_deals](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategy-parameters/list-strategy-deals.md): Get a list of strategy deals - [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 - [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 - [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 r - [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 - [GET /strategy_concepts](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategy-parameters/list-strategy-concepts.md): Get a list of strategy concepts - [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 - [GET /strategy_postal_codes](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategy-parameters/list-strategy-postal-codes.md): Get a list of strategy postal codes with default sort by `id DESC`. Can be queried by: - `id`, - `name`, - `value`, - `code`, - `exclude`, - `strategy_id` is required and can be sorted by: - `id`, - ` - [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 - [POST /validate_postal_codes](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategy-parameters/validate-postal-codes.md): Validates a list of postal codes. Input is `multipart/form-data` using either: - `file`: an uploaded CSV or newline-separated file of postal codes. - `content`: raw CSV or newline-separated text in th ## Strategy Templates - [POST /strategy_templates](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategy-templates/create-strategy-template.md): Create a strategy template - [GET /strategy_templates](https://apidocs.mediamath.com/apis/campaigns-api/openapi/strategy-templates/list-strategy-template.md): Get a list of strategy templates - [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 /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 /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 ## Place Lists ## Segment Groups - [POST /segment_groups](https://apidocs.mediamath.com/apis/campaigns-api/openapi/segment-groups/create-segment-group.md): Create a segment group - [GET /segment_groups](https://apidocs.mediamath.com/apis/campaigns-api/openapi/segment-groups/list-segment-groups.md): Get a list of segment groups - [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 /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 - [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_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 ## Targeting - [GET /target](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/list-targets-legacy.md): Get a list of targets - [POST /target](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/create-target-legacy.md): Create a target - [GET /target/{target_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/get-target-legacy.md): Get a target by ID - [POST /target/{target_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/update-target-legacy.md): Update a target by ID - [DELETE /target/{target_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/delete-target-legacy.md): Delete a target by ID - [PUT /target/{target_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/put-update-target-legacy.md): Update a target by ID - [GET /targets](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/list-targets.md): Get a list of targets - [POST /targets](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/create-target.md): Create a target - [GET /targets/{target_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/get-target.md): Get a target by ID - [POST /targets/{target_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/update-target.md): Update a target by ID - [DELETE /targets/{target_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/delete-target.md): Delete a target by ID - [GET /target-path](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/list-target-paths-legacy.md): Get a list of target paths - [POST /targeting](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/add-view-targeting.md): Add and view targeting - [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 /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 - [GET /audience_taxonomies](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/get-audience-taxonomies.md): Returns a paginated list of audience segment taxonomies, each with its full nested segment tree. Results can be filtered with `q=` and sorted with `sort_by=`. **Filterable / sortable fields:** | Field - [POST /audience_taxonomies](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/post-audience-taxonomies-create.md): Creates a new audience segment taxonomy with nested hierarchical structure. Access is scoped to the vendor's owning organization; `visibility=GLOBAL` and `revenue_share_pct` may be set only by global - [GET /audience_taxonomies/{taxonomy_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/get-audience-taxonomy.md): Returns a single audience segment taxonomy by ID with its full nested segment tree. - [POST /audience_taxonomies/{taxonomy_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/post-audience-taxonomy-update.md): Updates metadata and replaces the taxonomy tree for an existing audience segment taxonomy. Access is scoped to the vendor's owning organization; `visibility=GLOBAL` and `revenue_share_pct` may be set - [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. - [POST /audience_segments/cpm_estimate](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/audience-segments-cpm-estimate.md): Audience segments CPM estimate - [GET /vendor/audience_configs](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/get-vendor-audience-config.md): Retrieves all vendor audience configurations. Only accessible to global admins. - [POST /vendor/audience_configs](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/post-vendor-audience_configs.md): Creates or updates a vendor audience configuration. Only accessible to global admins. - [GET /vendor/{vendor_id}/audience_configs](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/get-vendor-audience-config-vendor-id.md): Retrieves a vendor audience configuration by vendor ID. Only accessible to global admins. - [POST /vendor/{vendor_id}/audience_configs](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/put-vendor-audience-config-vendor-id.md): Updates a vendor audience configuration by vendor ID. Only accessible to global admins. - [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`, - `par - [GET /path_targeting_segments](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting/list-contextual-segments.md): Get a list of contextual 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 = do ## Targeting 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_be - [POST /attachments](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-attachments/create-attachment.md): Create an attachment - [GET /attachment](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-attachments/list-attachments-legacy.md): Get a list of attachments - [POST /attachment](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-attachments/create-attachment-legacy.md): Create an attachment - [GET /attachments/{attachment_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-attachments/get-attachment.md): Get an attachment by ID - [POST /attachments/{attachment_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-attachments/update-attachment.md): Update an attachment by ID - [DELETE /attachments/{attachment_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-attachments/delete-attachment.md): Delete an attachment by ID - [GET /attachment/{attachment_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-attachments/get-attachment-legacy.md): Get an attachment by ID - [PUT /attachment/{attachment_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-attachments/update-attachment-legacy.md): Update an attachment by ID - [DELETE /attachment/{attachment_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-attachments/delete-attachment-legacy.md): Delete an attachment by ID ## 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 /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 ## 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 - [POST /targeting_segments/taxonomy_upload](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-segments/targeting-segments-taxonomy-upload.md): Validates a CSV taxonomy file for the given targeting vendor and returns an impact report (segment counts before/after, diff, affected strategies). **Nothing is written to the database** — this is a d - [POST /targeting_segments/taxonomy_upload/apply](https://apidocs.mediamath.com/apis/campaigns-api/openapi/targeting-segments/targeting-segments-taxonomy-upload-apply.md): Validates a CSV taxonomy file for the given targeting vendor and, if valid, commits all changes to the database (inserts, updates, retirements). Returns the same impact report as the dry-run endpoint, ## Atomic Creatives - [POST /creative_draft](https://apidocs.mediamath.com/apis/campaigns-api/openapi/atomic-creatives/preview-creative-assets.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 actual - [POST /creative_upload](https://apidocs.mediamath.com/apis/campaigns-api/openapi/atomic-creatives/upload-creative-assets.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, th - [GET /atomic_creatives](https://apidocs.mediamath.com/apis/campaigns-api/openapi/atomic-creatives/list-atomic-creatives.md): Get a list of atomic creatives - [POST /atomic_creatives](https://apidocs.mediamath.com/apis/campaigns-api/openapi/atomic-creatives/post-atomic_creatives.md): Create 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 - [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 - [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 - [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). - [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 - [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`, - `archived`, - `created_on`, - `updated_on`, - `advertiser_name` and queried by - [POST /concepts](https://apidocs.mediamath.com/apis/campaigns-api/openapi/concepts/create-concept.md): Create a concept - [GET /concepts/{concept_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/concepts/get-concept.md): Get a concept by ID - [POST /concepts/{concept_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/concepts/update-concept.md): Update a concept by ID - [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 - [POST /bulk_update/concepts](https://apidocs.mediamath.com/apis/campaigns-api/openapi/concepts/bulk-update-concepts.md): Update multiple concepts ## Creatives - [GET /creatives/{creative_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/creatives/get-creative.md): Get a creative by ID ## Pixel Bundles - [POST /pixel_bundles](https://apidocs.mediamath.com/apis/campaigns-api/openapi/pixel-bundles/create-pixel-bundle.md): Create a pixel bundle - [GET /pixel_bundles](https://apidocs.mediamath.com/apis/campaigns-api/openapi/pixel-bundles/list-pixel-bundles.md): Get a list of pixel bundles - [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 /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 - [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 - [GET /pixel_providers](https://apidocs.mediamath.com/apis/campaigns-api/openapi/pixel-providers/list-pixel-providers.md): Get all pixel providers ## 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 - [POST /audience_vendors](https://apidocs.mediamath.com/apis/campaigns-api/openapi/audience-vendors/create-audience-vendor.md): Create 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 - [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 ## Contracts - [POST /contracts](https://apidocs.mediamath.com/apis/campaigns-api/openapi/contracts/create-contract.md): Create a contract - [GET /contracts](https://apidocs.mediamath.com/apis/campaigns-api/openapi/contracts/list-contracts.md): Get a list of contracts - [POST /contracts/{contract_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/contracts/update-contract.md): Update a contract by ID - [GET /contracts/{contract_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/contracts/get-contract.md): Get a contract by ID - [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 ## Marketplaces - [GET /marketplaces/{marketplace_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/marketplaces/get-marketplace.md): Get a marketplace by ID - [POST /marketplaces/{marketplace_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/marketplaces/update-marketplace.md): Update a marketplace by ID - [GET /marketplaces](https://apidocs.mediamath.com/apis/campaigns-api/openapi/marketplaces/list-marketplaces.md): Get a list of marketplaces - [POST /marketplaces](https://apidocs.mediamath.com/apis/campaigns-api/openapi/marketplaces/create-marketplace.md): Create a marketplace ## Vendor Contracts - [GET /vendor_contracts](https://apidocs.mediamath.com/apis/campaigns-api/openapi/vendor-contracts/list-vendor-contracts.md): List vendor contracts ## 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 /vendors/{vendor_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/vendors/get-vendor.md): Get a vendor by ID - [GET /vendors/taxonomies](https://apidocs.mediamath.com/apis/campaigns-api/openapi/vendors/list-vendor-taxonomies.md): Returns taxonomy root nodes grouped by vendor for the provided advertiser. ## Enterprise Controls - [GET /entity_groups](https://apidocs.mediamath.com/apis/campaigns-api/openapi/enterprise-controls/list-entity-groups.md): Get a list of entity groups - [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_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 - [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 ## User Permissions - [POST /users/{user_id}/permissions](https://apidocs.mediamath.com/apis/campaigns-api/openapi/user-permissions/update-permissions-user.md): Update Permissions for a User - [GET /permissions/{user_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/user-permissions/list-user-permissions.md): Get a list of user permissions - [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 - [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 - [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 - [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 - [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 - [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 - [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 - [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 ## Users - [GET /users](https://apidocs.mediamath.com/apis/campaigns-api/openapi/users/list-users.md): Get a list of users - [POST /users](https://apidocs.mediamath.com/apis/campaigns-api/openapi/users/create-user.md): Create a user - [GET /users/{user_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/users/get-user.md): Get a user by ID - [POST /users/{user_id}](https://apidocs.mediamath.com/apis/campaigns-api/openapi/users/update-user.md): Update a user by ID - [GET /users/{user_id}/history](https://apidocs.mediamath.com/apis/campaigns-api/openapi/users/user-audit-log.md): Get a list of changes to this user - [GET /users/{user_id}/settings](https://apidocs.mediamath.com/apis/campaigns-api/openapi/users/get-user-settings.md): Get user's settings by ID - [POST /users/{user_id}/settings](https://apidocs.mediamath.com/apis/campaigns-api/openapi/users/update-user-settings.md): Update user's settings by ID ## 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 ## 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 ## General - [GET /healthcheck](https://apidocs.mediamath.com/apis/campaigns-api/openapi/general/healthcheck.md): Health endpoint to check availability - [GET /roles](https://apidocs.mediamath.com/apis/campaigns-api/openapi/general/list-roles.md): Get list of roles - [GET /search](https://apidocs.mediamath.com/apis/campaigns-api/openapi/general/search-entities.md): Search organizations, agencies or advertisers by name - [GET /target_values](https://apidocs.mediamath.com/apis/campaigns-api/openapi/general/list-target-values.md): Get list of target values ## 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`, - `site - [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 - [POST /site_lists/upload](https://apidocs.mediamath.com/apis/campaigns-api/openapi/site-lists/upload-create-site-lists.md): Upload new 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 - [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 - [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 ## 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 /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 ## Timezones - [GET /timezones](https://apidocs.mediamath.com/apis/campaigns-api/openapi/timezones/list-timezones.md): Get a list of timezones ## Verticals - [GET /verticals](https://apidocs.mediamath.com/apis/campaigns-api/openapi/verticals/list-verticals.md): Get all verticals