> ## 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.

# Create Social Engagement Signal

> 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>Creates a named Social Engagement signal, its own draft Flow Plan, and zero or more monitored LinkedIn profiles/company pages.</li>
<li>Requires team admin access and paid or trial access.</li>
<li>The signal&#39;s tracking mode applies to all its profiles and cannot be changed.</li>
<li>Collection starts asynchronously when eligible and can consume FirstTouch credits, even while the linked flow is draft; loadHistory can also consume credits.</li>
<li>Each seat allows five nondeleted monitors across the team, including paused monitors.</li>
<li>The generated flow starts in draft with manual enrollment; creation does not publish it, enroll contacts, or send outreach.</li>
<li>Return signalId and flowPlanId for subsequent monitoring and flow configuration.</li>
<li>This operation is not idempotent; inspect existing signals before retrying an uncertain result.</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.