> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firsttouch.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> For API operations, fetch https://gateway.firsttouch.ai/api/public/openapi.json for the complete input/output schemas, internal references, and x-mcp-annotations. Endpoint Markdown intentionally omits generated schema fragments. Select /api/public/tools/<tool_name> using the exact underscore-separated name. Send requests to https://gateway.firsttouch.ai; the canonical document currently omits servers. Start at https://docs.firsttouch.com/api-reference/agent-start.md.

# List Social Engagement Engagers

> Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling.

Read get_guide with topic=social_engagement before using this tool; reuse it if already read for the current request.

<details>
<summary><strong>Detailed usage guidance</strong></summary>
<ul>
<li>Lists stored Social Engagement engagers using FirstTouch data only.</li>
<li>Requires team owner/admin access.</li>
<li>Supply profileId for one exact monitored subscription, linkedinUrl for that URL across all team signals, or signalId for all monitored profiles in that signal without a URL.</li>
<li>Supplied selectors combine with AND.</li>
<li>Requires at least one selector.</li>
<li>Filters by engagementType, exact postUrl, and engagement time before deduplication, counting, and pagination across the complete selection.</li>
<li>Defaults earliestEngagementPerContact=true: one earliest matching event by engaged_at per contact, across team signals for a URL-only call or within the selected signal/subscription.</li>
<li>With false, URL-only calls deduplicate by person plus saved event key across signals while preserving different actions by the same person; scoped calls retain all matching saved events.</li>
<li>Returns saved data without fetching live engagement.</li>
</ul>
</details>



## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.firsttouch.com/llms.txt).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.