---
title: "create_linkedin_engagement_retargeting_audience. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/create_linkedin_engagement_retargeting_audience
description: "Create a **LinkedIn Engagement Retargeting** audience: people who already engaged with the advertiser's LinkedIn ads, company page, or website. Writes tool on the Metadata MCP server, with its full JSON Schema."
source: metadata.io
---

# create_linkedin_engagement_retargeting_audience

Create a **LinkedIn Engagement Retargeting** audience: people who already engaged with the advertiser's LinkedIn ads, company page, or website.

Writes [analytics](https://metadata.io/developers/tools/#cat-analytics)

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `name` | string | required | Name for the new audience. Prefer something that describes the rule (e.g. 'Video 50% viewers 90d') so it is recognisable later. |
| `source_platform` | string | required | The `engagementSourceType` chosen from get_linkedin_engagement_source_types — e.g. VIDEO_ADS, SINGLE_IMAGE_ADS, DOCUMENT_ADS, CONVERSATION_ADS, LEAD_GEN_FORMS, ORGANIZATION_PAGES, or WEBSITE. WEBSITE switches this tool to the URL-rule shape. |
| `engagement_trigger` | string | required | An `engagementTrigger` listed for THAT source type (e.g. FIRST_QUARTILE for VIDEO_ADS, LEAD_FORM_SUBMIT for LEAD_GEN_FORMS, VISIT for WEBSITE). A trigger from a DIFFERENT source type is accepted without error and silently builds an audience that never populates, so take it from this source type's ow |
| `lookback_window_days` | integer | required | How far back engagement counts, and how long a member is retained. WEBSITE accepts 30/60/90/180 only; every other source type also accepts 365.one of: `30`, `60`, `90`, `180`, `365` |
| `engagement_source_urns` | array |   | LinkedIn URNs to retarget, taken verbatim from the `id` of each chosen search_linkedin_engagement_sources result. Required for every source type EXCEPT WEBSITE, and must be omitted for WEBSITE. Multiple URNs union their audiences. |
| `page_set_name` | string |   | WEBSITE only: internal label for the URL rule set created on LinkedIn (e.g. 'Pricing and demo pages'). Required when source_platform is WEBSITE. |
| `url_match_groups` | array |   | WEBSITE only: OR-of-ANDs URL expression. The outer list is ORed, rules inside a group are ANDed. For a plain 'any of these pages' list, use one rule per group. Required when source_platform is WEBSITE. |

## Request

**Request template, not a complete runnable example.** Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

## Response

## Related

Other analytics tools:

- [account_funnel_reports](https://metadata.io/developers/tools/account_funnel_reports) Read
- [account_level_stats](https://metadata.io/developers/tools/account_level_stats) Read
- [account_list_performance](https://metadata.io/developers/tools/account_list_performance) Read
- [budget_group_performance](https://metadata.io/developers/tools/budget_group_performance) Read
- [deep_funnel_stats](https://metadata.io/developers/tools/deep_funnel_stats) Read
- [demographic_country_stats](https://metadata.io/developers/tools/demographic_country_stats) Read
- [experiment_performance_stats](https://metadata.io/developers/tools/experiment_performance_stats) Read
- [get_account_opportunities_insights](https://metadata.io/developers/tools/get_account_opportunities_insights) Read

[Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)