> ## 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/ 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. # Operation Catalog > Find every FirstTouch API operation by workflow, with direct Markdown links. This catalog maps all 68 operations in the canonical contract checked on September 9, 2026. Choose a workflow below, then open the operation's reference or Markdown export. Consult the [live OpenAPI document](https://gateway.firsttouch.ai/api/public/openapi.json) for the current catalog, complete schemas, descriptions, and MCP annotations. Every operation uses `POST https://gateway.firsttouch.ai/api/public/tools/` with an `X-API-Key` header and a JSON object body. Keep underscores in the tool name; the hyphenated documentation URL is not the API path. Start with [Agent Start Here](/api-reference/agent-start) and the [quickstart](/api-reference/quickstart). Before writes or charged work, read the specific operation's prerequisites, permission requirements, costs, and side effects. A read-only annotation does not imply an operation is free. See [execution and recovery](/api-reference/execution-and-recovery) before retrying an ambiguous result. ## Account, Team, And Guidance Start with the active identity and capabilities; use the relevant guide before workflow operations. | Operation | Use | Agent reference | | -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | | [`get_current_user`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-current-user) | Inspect the authenticated user, team, and permissions. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-current-user.md) | | [`get_auth_scopes`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-auth-scopes) | Inspect capabilities for the current request and subscription. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-auth-scopes.md) | | [`list_team_members`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-team-members) | Resolve team members and sender capabilities. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-team-members.md) | | [`get_guide`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-guide) | Load a supported workflow guide topic. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-guide.md) | ## Contacts, Discovery, And Enrichment Use existing-data lookup before charged enrichment. Discovery and enrichment have credit rules; load the contact\_discovery guide before discovery or background import. | Operation | Use | Agent reference | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | [`find_contact_data`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/find-contact-data) | Look up contact data already held by the team. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/find-contact-data.md) | | [`get_contact_discovery_industry_values`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-contact-discovery-industry-values) | Find supported discovery industry values. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-contact-discovery-industry-values.md) | | [`discover_contacts`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/discover-contacts) | Preview or paginate a charged contact search. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/discover-contacts.md) | | [`start_contact_discovery_audience_import`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/start-contact-discovery-audience-import) | Start a background import from contact discovery. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/start-contact-discovery-audience-import.md) | | [`get_contact_discovery_audience_import_status`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-contact-discovery-audience-import-status) | Inspect an import and recover partial results. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-contact-discovery-audience-import-status.md) | | [`enrich_contact`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/enrich-contact) | Request contact enrichment. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/enrich-contact.md) | | [`enrich_company`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/enrich-company) | Request company enrichment. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/enrich-company.md) | | [`enrich_email`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/enrich-email) | Find or enrich an email address. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/enrich-email.md) | | [`enrich_phone`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/enrich-phone) | Find or enrich a phone number. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/enrich-phone.md) | ## Audiences And HubSpot Lists Use Audiences for lists or groups of contacts. Review the audience\_management guide and the operation-specific source requirements. | Operation | Use | Agent reference | | -------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | | [`list_audiences`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-audiences) | Find existing audiences. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-audiences.md) | | [`create_audience`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/create-audience) | Create an audience from a supported source. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/create-audience.md) | | [`create_audience_from_profiles`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/create-audience-from-profiles) | Create an audience from selected profiles. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/create-audience-from-profiles.md) | | [`add_audience_contacts`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/add-audience-contacts) | Add contacts to an audience. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/add-audience-contacts.md) | | [`delete_audience`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/delete-audience) | Delete an audience. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/delete-audience.md) | | [`list_hubspot_lists`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-hubspot-lists) | Find HubSpot lists. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-hubspot-lists.md) | | [`preview_hubspot_list`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/preview-hubspot-list) | Inspect a HubSpot list before using it. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/preview-hubspot-list.md) | ## Flow Plans Use reusable Flow Plans for multi-contact workflows. Load flow\_plan\_creation, inspect validation, and review publication and enrollment settings before activation. | Operation | Use | Agent reference | | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- | | [`list_flow_plans`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-flow-plans) | Find and compare flow plans. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-flow-plans.md) | | [`create_flow_plan`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/create-flow-plan) | Create a flow plan. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/create-flow-plan.md) | | [`get_flow_workspace`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-flow-workspace) | Inspect a flow workspace and validation context. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-flow-workspace.md) | | [`get_flow_source_modes`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-flow-source-modes) | Inspect supported flow source modes. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-flow-source-modes.md) | | [`get_flow_available_variables`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-flow-available-variables) | Inspect variables available for a flow. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-flow-available-variables.md) | | [`attach_audience_to_flow`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/attach-audience-to-flow) | Connect an audience to a flow. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/attach-audience-to-flow.md) | | [`update_flow_plan`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/update-flow-plan) | Update supported flow settings. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/update-flow-plan.md) | | [`replace_flow_root`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/replace-flow-root) | Replace a flow action tree. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/replace-flow-root.md) | | [`manage_flow_publication`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/manage-flow-publication) | Change flow publication state. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/manage-flow-publication.md) | | [`delete_flow_plan`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/delete-flow-plan) | Delete a flow plan. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/delete-flow-plan.md) | ## Enrollments And Single-Contact Actions Load enrollment\_management for regular enrollments or dynamic\_actions for a one-contact action. Dynamic Actions require identity, enrollment, and sender preflight; retain the returned write receipt. | Operation | Use | Agent reference | | ---------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | | [`list_enrollments`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-enrollments) | Find enrollments across accessible flows. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-enrollments.md) | | [`list_flow_plan_enrollments`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-flow-plan-enrollments) | Inspect enrollments for a flow plan. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-flow-plan-enrollments.md) | | [`get_flow_enrollment`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-flow-enrollment) | Inspect one enrollment and its action details. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-flow-enrollment.md) | | [`add_manual_flow_enrollment`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/add-manual-flow-enrollment) | Add a manual flow enrollment. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/add-manual-flow-enrollment.md) | | [`enroll_awaiting_flow_items`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/enroll-awaiting-flow-items) | Start selected awaiting flow items. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/enroll-awaiting-flow-items.md) | | [`cancel_flow_enrollments`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/cancel-flow-enrollments) | Cancel selected flow enrollments. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/cancel-flow-enrollments.md) | | [`validate_flow_reenroll`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/validate-flow-reenroll) | Validate items before re-enrollment. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/validate-flow-reenroll.md) | | [`reenroll_flow_enrollments`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/reenroll-flow-enrollments) | Re-enroll selected flow items. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/reenroll-flow-enrollments.md) | | [`find_mcp_enrollment`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/find-mcp-enrollment) | Find existing Dynamic Actions enrollment candidates. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/find-mcp-enrollment.md) | | [`add_dynamic_action`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/add-dynamic-action) | Append one action step for one contact. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/add-dynamic-action.md) | | [`remove_dynamic_action_prospect`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/remove-dynamic-action-prospect) | Remove a contact from Dynamic Actions. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/remove-dynamic-action-prospect.md) | ## Tasks, Queues, And Diagnostics Preview approval tasks before authorized completion. Inspect enrollments and tasks as well as queues when diagnosing work that has not run. | Operation | Use | Agent reference | | ------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | | [`list_user_tasks`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-user-tasks) | Find tasks requiring attention. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-user-tasks.md) | | [`preview_task`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/preview-task) | Inspect a task and its action content. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/preview-task.md) | | [`edit_task_action`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/edit-task-action) | Edit supported task action content. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/edit-task-action.md) | | [`complete_task`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/complete-task) | Complete or approve an authorized task. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/complete-task.md) | | [`skip_task`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/skip-task) | Skip a selected task. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/skip-task.md) | | [`list_email_send_queue`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-email-send-queue) | Inspect submitted email sends. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-email-send-queue.md) | | [`list_linkedin_outreach_queue`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-linkedin-outreach-queue) | Inspect LinkedIn outreach queue state. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-linkedin-outreach-queue.md) | | [`get_outreach_queue_insights`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-outreach-queue-insights) | Inspect outreach queue insights. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-outreach-queue-insights.md) | | [`get_contact_trace`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-contact-trace) | Trace contact workflow activity. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-contact-trace.md) | ## LinkedIn Inbox And Connections Read the exact conversation before replying. send\_linkedin\_unibox\_message requires explicitly requested or approved text and must never be retried automatically. | Operation | Use | Agent reference | | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | [`list_linkedin_team_connections`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-linkedin-team-connections) | Inspect saved team LinkedIn connections. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-linkedin-team-connections.md) | | [`list_linkedin_unibox_conversations`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-linkedin-unibox-conversations) | Find LinkedIn inbox conversations. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-linkedin-unibox-conversations.md) | | [`get_linkedin_unibox_conversation`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-linkedin-unibox-conversation) | Inspect one LinkedIn conversation. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-linkedin-unibox-conversation.md) | | [`get_linkedin_unibox_counts`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-linkedin-unibox-counts) | Inspect LinkedIn inbox counts. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-linkedin-unibox-counts.md) | | [`update_linkedin_unibox_conversation_state`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/update-linkedin-unibox-conversation-state) | Update supported conversation state. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/update-linkedin-unibox-conversation-state.md) | | [`send_linkedin_unibox_message`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/send-linkedin-unibox-message) | Send an explicitly authorized reply. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/send-linkedin-unibox-message.md) | ## Social Engagement Inspect the existing linked Social Engagement flow. Adding or activating monitored profiles requires the documented role and paid, non-trial access. | Operation | Use | Agent reference | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | | [`get_social_engagement_config`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-social-engagement-config) | Inspect team Social Engagement configuration. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-social-engagement-config.md) | | [`write_social_engagement_config`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/write-social-engagement-config) | Change Social Engagement configuration. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/write-social-engagement-config.md) | | [`list_social_engagement_monitored_profiles`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-social-engagement-monitored-profiles) | Find monitored profiles. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-social-engagement-monitored-profiles.md) | | [`manage_social_engagement_monitored_profile`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/manage-social-engagement-monitored-profile) | Add or manage a monitored profile. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/manage-social-engagement-monitored-profile.md) | | [`list_social_engagement_engagers`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-social-engagement-engagers) | Inspect captured engagers. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-social-engagement-engagers.md) | ## Metrics, Credits, And Billing Inspect current costs and credit context before charged work. Access to team-wide metrics and billing data depends on the caller. | Operation | Use | Agent reference | | ------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | | [`get_team_metrics`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-team-metrics) | Inspect team outreach and engagement metrics. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-team-metrics.md) | | [`get_feature_costs`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-feature-costs) | Inspect current feature costs. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-feature-costs.md) | | [`get_credits_usage`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-credits-usage) | Inspect credit usage context. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-credits-usage.md) | | [`get_user_credit_usage`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-user-credit-usage) | Inspect user credit usage. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/get-user-credit-usage.md) | | [`list_flow_plan_credits_usage`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-flow-plan-credits-usage) | Inspect flow plan credit usage. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-flow-plan-credits-usage.md) | | [`list_credit_transactions`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-credit-transactions) | Inspect credit transactions. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-credit-transactions.md) | | [`list_purchases`](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-purchases) | Inspect purchases. | [Markdown](https://docs.firsttouch.com/api-reference/operations/firsttouch-tools/list-purchases.md) |