Operation Catalog

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 for the current catalog, complete schemas, descriptions, and MCP annotations. Every operation uses POST https://gateway.firsttouch.ai/api/public/tools/<tool_name> 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 and the 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 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`	Inspect the authenticated user, team, and permissions.	Markdown
`get_auth_scopes`	Inspect capabilities for the current request and subscription.	Markdown
`list_team_members`	Resolve team members and sender capabilities.	Markdown
`get_guide`	Load a supported workflow guide topic.	Markdown

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`	Look up contact data already held by the team.	Markdown
`get_contact_discovery_industry_values`	Find supported discovery industry values.	Markdown
`discover_contacts`	Preview or paginate a charged contact search.	Markdown
`start_contact_discovery_audience_import`	Start a background import from contact discovery.	Markdown
`get_contact_discovery_audience_import_status`	Inspect an import and recover partial results.	Markdown
`enrich_contact`	Request contact enrichment.	Markdown
`enrich_company`	Request company enrichment.	Markdown
`enrich_email`	Find or enrich an email address.	Markdown
`enrich_phone`	Find or enrich a phone number.	Markdown

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`	Find existing audiences.	Markdown
`create_audience`	Create an audience from a supported source.	Markdown
`create_audience_from_profiles`	Create an audience from selected profiles.	Markdown
`add_audience_contacts`	Add contacts to an audience.	Markdown
`delete_audience`	Delete an audience.	Markdown
`list_hubspot_lists`	Find HubSpot lists.	Markdown
`preview_hubspot_list`	Inspect a HubSpot list before using it.	Markdown

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`	Find and compare flow plans.	Markdown
`create_flow_plan`	Create a flow plan.	Markdown
`get_flow_workspace`	Inspect a flow workspace and validation context.	Markdown
`get_flow_source_modes`	Inspect supported flow source modes.	Markdown
`get_flow_available_variables`	Inspect variables available for a flow.	Markdown
`attach_audience_to_flow`	Connect an audience to a flow.	Markdown
`update_flow_plan`	Update supported flow settings.	Markdown
`replace_flow_root`	Replace a flow action tree.	Markdown
`manage_flow_publication`	Change flow publication state.	Markdown
`delete_flow_plan`	Delete a flow plan.	Markdown

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`	Find enrollments across accessible flows.	Markdown
`list_flow_plan_enrollments`	Inspect enrollments for a flow plan.	Markdown
`get_flow_enrollment`	Inspect one enrollment and its action details.	Markdown
`add_manual_flow_enrollment`	Add a manual flow enrollment.	Markdown
`enroll_awaiting_flow_items`	Start selected awaiting flow items.	Markdown
`cancel_flow_enrollments`	Cancel selected flow enrollments.	Markdown
`validate_flow_reenroll`	Validate items before re-enrollment.	Markdown
`reenroll_flow_enrollments`	Re-enroll selected flow items.	Markdown
`find_mcp_enrollment`	Find existing Dynamic Actions enrollment candidates.	Markdown
`add_dynamic_action`	Append one action step for one contact.	Markdown
`remove_dynamic_action_prospect`	Remove a contact from Dynamic Actions.	Markdown

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`	Find tasks requiring attention.	Markdown
`preview_task`	Inspect a task and its action content.	Markdown
`edit_task_action`	Edit supported task action content.	Markdown
`complete_task`	Complete or approve an authorized task.	Markdown
`skip_task`	Skip a selected task.	Markdown
`list_email_send_queue`	Inspect submitted email sends.	Markdown
`list_linkedin_outreach_queue`	Inspect LinkedIn outreach queue state.	Markdown
`get_outreach_queue_insights`	Inspect outreach queue insights.	Markdown
`get_contact_trace`	Trace contact workflow activity.	Markdown

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`	Inspect saved team LinkedIn connections.	Markdown
`list_linkedin_unibox_conversations`	Find LinkedIn inbox conversations.	Markdown
`get_linkedin_unibox_conversation`	Inspect one LinkedIn conversation.	Markdown
`get_linkedin_unibox_counts`	Inspect LinkedIn inbox counts.	Markdown
`update_linkedin_unibox_conversation_state`	Update supported conversation state.	Markdown
`send_linkedin_unibox_message`	Send an explicitly authorized reply.	Markdown

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`	Inspect team Social Engagement configuration.	Markdown
`write_social_engagement_config`	Change Social Engagement configuration.	Markdown
`list_social_engagement_monitored_profiles`	Find monitored profiles.	Markdown
`manage_social_engagement_monitored_profile`	Add or manage a monitored profile.	Markdown
`list_social_engagement_engagers`	Inspect captured engagers.	Markdown

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`	Inspect team outreach and engagement metrics.	Markdown
`get_feature_costs`	Inspect current feature costs.	Markdown
`get_credits_usage`	Inspect credit usage context.	Markdown
`get_user_credit_usage`	Inspect user credit usage.	Markdown
`list_flow_plan_credits_usage`	Inspect flow plan credit usage.	Markdown
`list_credit_transactions`	Inspect credit transactions.	Markdown
`list_purchases`	Inspect purchases.	Markdown

Start Here

Web App

Public API

Chrome Extension

References

Account, Team, And Guidance

Contacts, Discovery, And Enrichment

Audiences And HubSpot Lists

Flow Plans

Enrollments And Single-Contact Actions

Tasks, Queues, And Diagnostics

LinkedIn Inbox And Connections

Metrics, Credits, And Billing

​Account, Team, And Guidance

​Contacts, Discovery, And Enrichment

​Audiences And HubSpot Lists

​Flow Plans

​Enrollments And Single-Contact Actions

​Tasks, Queues, And Diagnostics

​LinkedIn Inbox And Connections

​Social Engagement

​Metrics, Credits, And Billing

Account, Team, And Guidance

Contacts, Discovery, And Enrichment

Audiences And HubSpot Lists

Flow Plans

Enrollments And Single-Contact Actions

Tasks, Queues, And Diagnostics

LinkedIn Inbox And Connections

Social Engagement

Metrics, Credits, And Billing