# gtm-api

> REST API and MCP server for LinkedIn outreach infrastructure: connected accounts, messaging, enrichment, mass actions and webhooks.

## Docs

- [gtm-api documentation](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/index.md): A typed REST API and MCP server for LinkedIn outreach infrastructure: connected accounts, messaging, enrichment, mass actions and webhooks.
- [Quickstart](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/quickstart.md): Mint an API key and make your first authenticated call.
- [Authentication](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/authentication.md): API keys, session JWTs and team scoping.
- [Envelopes and errors](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/concepts/envelopes-and-errors.md): One response wrapper for every success, one error format with a closed 16-code taxonomy.
- [Pagination and filtering](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/concepts/pagination-and-filtering.md): Cursor paging, typed per-field filters, includes, and how objects travel in query strings.
- [Run a mass action](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/guides/run-a-mass-action.md): Preview a bulk plan, commit it with the consent token, then monitor the run to settlement.
- [Receive webhooks](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/guides/receive-webhooks.md): Register an endpoint, verify signed deliveries, filter what you receive, and read the delivery log. Includes the retry policy and the auto-disable rule.
- [Knowledge base](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/kb/index.md): How the platform works: accounts and browsers, safety and pacing, finding and enriching people, conversations, billing, and what to do when something breaks.
- [Connect a LinkedIn account](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/kb/connect-a-linkedin-account.md): Connect an account in the app, wait out the initial sync, then work with it over the API. The login happens inside a dedicated antidetect browser; no password ever reaches the platform.
- [Antidetect browsers and proxies](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/kb/antidetect-browsers-and-proxies.md): Every LinkedIn account runs in its own isolated browser profile with a stable fingerprint and its own proxy. What the browser does, how proxies attach, and how to diagnose both.
- [Share or transfer a connected account](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/kb/account-sharing-and-handover.md): Lend a connected LinkedIn account to another workspace and get it back, or hand ownership over permanently. Covers what the receiving side gets, what happens to the browser and the sync, and every statu…
- [Smart limits and warmup](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/kb/smart-limits-and-warmup.md): Per-action daily budgets protect every LinkedIn account, and a warmup ramp grows them as a new account proves itself. How budgets, holds and warmup work.
- [Sync windows and auto-suspend](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/kb/sync-windows-and-auto-suspend.md): Recurring syncs run inside each account's configured hours, idle browsers suspend themselves, and due work wakes them. What is window-gated and what is not.
- [Account health](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/kb/account-health.md): Every connected LinkedIn account carries a warmup score built from six compounding signals, a snapshot history, a limit-hit log and a block log. What each one records and what to do about it.
- [People and company search](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/kb/people-and-company-search.md): Run one live page of a LinkedIn or Sales Navigator people or company search: the pasted-URL and structured-filter input styles, how ids are resolved, what a row contains, and what a page costs.
- [Find an email or phone number for a profile](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/kb/enrichment.md): Run contact enrichment on one LinkedIn profile: what comes back, which of your connected accounts it runs on, and how to read a partial result.
- [Collect leads with an auto-scrape](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/kb/auto-scrapes.md): Save a LinkedIn or Sales Navigator search as a recurring collector, deduplicate what it finds across runs, and feed the new leads into a standing mass action.
- [Inbox and message sync](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/kb/inbox-and-message-sync.md): How conversations and messages reach the platform: what the initial backfill imports, how often each surface re-syncs, what realtime push covers, and why a message may not be there yet.
- [Workspaces and team members](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/kb/workspaces-and-team-members.md): What a workspace owns, how switching between them works, how member access is expressed, what an invite does, and why team members are off on the free plan.
- [Billing and plans](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/kb/billing-and-plans.md): Sandbox, the forever free plan you start on, how paid accounts are priced, and what happens when a payment fails or a subscription ends.
- [Proxy problems](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/kb/proxy-troubleshooting.md): LinkedIn will not load, the account keeps hitting verification, the browser stops overnight: how to tell a broken proxy from a lost session or normal auto-suspend, and what to do about each.
- [Browser will not start](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/kb/browser-troubleshooting.md): The antidetect browser sits in an issue status, the session dies right after starting, or LinkedIn keeps asking to log in. How to read the status, what the platform already did on its own, and when re-l…
- [API reference overview](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/overview.md): How to read the reference: base URLs, auth, the envelope, and the x-gtm operation flags.
- [Search antidetect browser logs](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/antidetect_browser_logs/search-antidetect-browser-logs.md): List antidetect-browser runtime log rows for the team with filters, sorting and cursor pagination. This is the operational trail behind a browser's status (start/stop, runtime errors, proxy issues, logo…
- [Check proxy connectivity](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/antidetect_browser_proxies/check-proxy-connectivity.md): Probe connectivity + latency for one or many proxies. Target EXACTLY ONE of sid (ab_px_) or filter; filter mode checks up to an inline cap and reports total_matched (truncated:true when the cap was hit)…
- [Check proxy location](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/antidetect_browser_proxies/check-proxy-location.md): Run a multi-vendor geo + fraud check on one or many proxies. Target EXACTLY ONE of sid (ab_px_) or filter; filter mode checks up to an inline cap and reports total_matched (truncated:true when the cap w…
- [Search antidetect browser proxies](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/antidetect_browser_proxies/search-antidetect-browser-proxies.md): List antidetect browser proxies (platform-wide pool) with filters, sorting and cursor pagination. Live proxies by default (deleted_at.is_null:true). Credentials (ip / port / username / password) are mas…
- [Create antidetect browser](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/antidetect_browsers/create-antidetect-browser.md): Provision ONE antidetect browser for the team. The main flow mints a fresh vendor (GoLogin) profile and pushes the resolved proxy into it, so supply exactly one proxy source: proxy_country_code is the d…
- [Generate cloud-browser access key](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/antidetect_browsers/generate-cloud-browser-access-key.md): Mint a cloud-browser access key (smart-link) on a browser so a user can sign into LinkedIn through the cloud browser. Returns the raw cb_ak_ key in result.access_key (shown once) AND result.public_conne…
- [Rotate antidetect browser proxy](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/antidetect_browsers/rotate-antidetect-browser-proxy.md): Rotate an antidetect browser onto another MANAGED proxy of the SAME country. Geo-binding is preserved, so this is the safe way to drop a flagged IP. Omit antidetect_browser_proxy_sid to take the least-l…
- [Revoke cloud-browser access key](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/antidetect_browsers/revoke-cloud-browser-access-key.md): Revoke a cloud-browser access key on a browser. Pass the cb_ak_ key to revoke one; omit key to revoke EVERY key on the row. Only removes the key; live cloud-browser sessions are not force-disconnected.…
- [Run antidetect browser](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/antidetect_browsers/run-antidetect-browser.md): Start an antidetect browser session by sid. Two-phase: transitions to queued_to_start, dispatches to an automation server, then settles into initializing / running / start_issue. Identify the browser by…
- [Search antidetect browsers](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/antidetect_browsers/search-antidetect-browsers.md): List antidetect browsers on the team with filters (name lookup via the vendor_name filter, eq/in), sorting and cursor pagination. Live browsers by default (deleted_at.is_null:true). Returns a counts blo…
- [Stop antidetect browser](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/antidetect_browsers/stop-antidetect-browser.md): Stop an antidetect browser session by sid. Default is graceful (queued_to_stop → stopped on the node teardown confirmation); now:true commits stopped immediately and dispatches a best-effort teardown. I…
- [Change antidetect browser proxy](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/antidetect_browsers/change-antidetect-browser-proxy.md): Change the proxy of an existing antidetect browser, country included. Supply EXACTLY ONE source: antidetect_browser_proxy_sid, proxy_country_code or custom_proxy_config. Pooled arms need browser_owner=p…
- [Get antidetect browser](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/antidetect_browsers/get-antidetect-browser.md): Fetch a single antidetect browser by sid, with optional eager-loaded relations.
- [Delete antidetect browser](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/antidetect_browsers/delete-antidetect-browser.md): Decommission (soft-delete) a single antidetect browser by sid: outward, destructive, one-way through MCP. Variant B cascade: the bound linkedin-account is soft-deleted and pending plugin tasks transitio…
- [Cloud browser sessions metrics](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/cloud_browser_sessions/cloud-browser-sessions-metrics.md): Period-bound aggregates over a filtered cloud-browser-session set. Requires period {from,to}. Returns total_count, active_count, avg_session_duration_seconds, login_success_rate, unique_devices_count an…
- [Search cloud browser sessions](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/cloud_browser_sessions/search-cloud-browser-sessions.md): List cloud-browser sessions on the team with filters, sorting and cursor pagination. This is the audit trail of who connected to which browser, from where, and how each login attempt resolved. The smart…
- [List cloud-browser team occupancy](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/cloud_browsers/list-cloud-browser-team-occupancy.md): List the cloud-browser slots the team currently occupies. Each slot carries the connected antidetect_browser sid, the connected user, and the connect / expiry timestamps. Read-only snapshot returned in…
- [Search data requests](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/data_requests/search-data-requests.md): List/filter the request history: what was asked, where it ran, what came from cache. The go-to tool for retry forensics (idempotency_key:{eq}), per-person request history (ln_member_id:{eq}) and mid-fli…
- [Get data request](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/data_requests/get-data-request.md): Fetch a single ledger row by sid to inspect one request referenced from a data-requests.* webhook or another row's cached_from_sid pointer.
- [LinkedIn account activity-log metrics](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_account_activity_log/linkedin-account-activity-log-metrics.md): Period-bound aggregates over a filtered activity-log set (avg plugin duration, avg pending age) plus the counts block and an optional group_by axis (action_type | status | linkedin_account_sid). Use for…
- [Search LinkedIn account activity log](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_account_activity_log/search-linkedin-account-activity-log.md): List activity-log rows, one per plugin call (Task↔Result cycle): pending on dispatch, then success / failed / skipped. Use for: "why is account X failing" (status:failed + created_at window, read error_…
- [Search LinkedIn account block log](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_account_block_log/search-linkedin-account-block-log.md): List per-target block observations for the team: one permanently-deduplicated row per (account, target) whenever a target profile blocked one of our accounts (established by the §5.6 check-target-block)…
- [Search LinkedIn account quota hits](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_account_quota_hits/search-linkedin-account-quota-hits.md): List LinkedIn-side block events (weekly connection-request cap, InMail rate-limit, a 429 on any action bucket, …) for the team: immutable, append-only, one row per (account, reason, bucket) per 12h dedu…
- [Search LinkedIn account smart limits](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_account_smart_limits/search-linkedin-account-smart-limits.md): List per-limit_type policy rows (one account owns 15 public buckets: send_connection_requests, send_messages, send_inmails, scraping, enrichment, custom_request, …) with filters, sorting, cursor paginat…
- [Update LinkedIn account smart limit](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_account_smart_limits/update-linkedin-account-smart-limit.md): Patch the operator-tunable policy of one limit row (daily_limit / target_limit / delay_in_seconds / smart_limits_enabled; at least one field OR reset_hold:true required). status is recomputed atomically…
- [Reset LinkedIn account smart-limit hold](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_account_smart_limits/reset-linkedin-account-smart-limit-hold.md): Clear OUR platform-side pause (hold_till = null) on one row. Prefer update({daily_limit:<higher>, reset_hold:true}) for the common "raise the cap AND resume". This standalone action is for resuming WITH…
- [Search LinkedIn account snapshots](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_account_snapshots/search-linkedin-account-snapshots.md): Per-account warmup snapshots over time (immutable, append-only, captured ~every 22h by the scheduler). Use for: a warmup trend over N days (filter linkedin_account_sid + created_at range), before/after…
- [LinkedIn account sync-run metrics](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_account_sync_runs/linkedin-account-sync-run-metrics.md): Aggregate sync-run counters for dashboards: a counts block (total + per-status: pending, in_progress, completed, cancelled) plus avg_completed_duration_seconds, with an optional group_by axis (status |…
- [Search LinkedIn account sync runs](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_account_sync_runs/search-linkedin-account-sync-runs.md): List sync runs: the backend-owned progress tracker for one paginated sync of one data surface (connections, connection_requests, connection_invitations, conversations, sales_navigator_conversations, fol…
- [Get LinkedIn account sync run](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_account_sync_runs/get-linkedin-account-sync-run.md): Fetch one sync run by sid, with includes (linkedin_account; activity_log_pages for the per-page fetch log; limit for the gating smart-limit bucket, always resolved). Use to drill into a single run's pro…
- [Search LinkedIn accounts](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_accounts/search-linkedin-accounts.md): List LinkedIn accounts on the team with filtering, sorting and cursor pagination. Returns a counts block of predicate tallies. Use this to find an account sid before calling account-scoped tools.
- [Get LinkedIn account](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_accounts/get-linkedin-account.md): Fetch a single LinkedIn account by sid, with optional eager-loaded relations.
- [Update account display fields](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_accounts/update-account-display-fields.md): Set the account's operator display fields: display_name and label. These are team-authored (never synced from LinkedIn) and are the only editable fields on the account row - sync cadence has its own too…
- [Check premium subscription](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_accounts/check-premium-subscription.md): Refresh the account's subscription state and persist it: Premium, the Sales Navigator and Recruiter seats, and the InMail balance (self-probe, no target, no credits). `checks` picks which of those four…
- [Check target reachability](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_accounts/check-target-reachability.md): Check whether a target person can be reached from this account (not blocked / out of network). Probes from the account itself; when the platform cannot obtain an independent second viewpoint the outcome…
- [Endorse skills](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_accounts/endorse-skills.md): Endorse a target person's skills from this account (warm-up / engagement action). Outward action on LinkedIn.
- [Get my analytics](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_accounts/get-my-analytics.md): Read the connected account's creator content analytics over a date window: per metric (impressions, engagements) the daily series, the period total, and the percentage change against the prior period. O…
- [Get my catch-up cards](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_accounts/get-my-catch-up-cards.md): The nurture cards on this account's My Network catch-up tab (linkedin.com/mynetwork/catch-up/all): birthdays, job changes and work anniversaries among its connections, each with the one-click message Li…
- [Get my credits](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_accounts/get-my-credits.md): Return the InMail / message credit balance for the connected account.
- [Get my following](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_accounts/get-my-following.md): List who the connected account follows, newest-first: the follow-edge twin of get-my-followers (§5.8 latest-*). A null cursor refreshes then returns the head page; a non-null cursor is a read-only conti…
- [Get my full profile](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_accounts/get-my-full-profile.md): Fetch the full self-profile of the connected LinkedIn account.
- [Get my lite profile](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_accounts/get-my-lite-profile.md): Fetch the lite self-profile (name, headline, avatar) of the connected account.
- [Get my profile views](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_accounts/get-my-profile-views.md): Who viewed this account's profile over the LAST 90 DAYS, newest first: the list behind linkedin.com/me/profile-views. Window and sort are fixed by LinkedIn and there is no filter, so "who viewed me toda…
- [Get my Sales Navigator alerts](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_accounts/get-my-sales-navigator-alerts.md): This account's Sales Navigator alert feed, the bell on linkedin.com/sales/home: saved leads and accounts posting, changing job, accepting an invitation, or turning up in a profile-view signal. NEEDS A S…
- [Get my sessions](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_accounts/get-my-sessions.md): List the active LinkedIn sessions for the connected account.
- [Get my SSI](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_accounts/get-my-ssi.md): Read the connected account's Social Selling Index: the overall score, the four pillars it is the sum of (professional brand, finding the right people, engaging with insights, building relationships), an…
- [Edit my profile](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_accounts/edit-my-profile.md): Edit the connected account's OWN LinkedIn profile intro card: name, headline, additional name, industry, location, the current position/education pins and their visibility, website, and pronouns. Send o…
- [Reset account sync](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_accounts/reset-account-sync.md): Reset one or more sync tracks for the account and re-run them from scratch. ASYNC: returns pending refs to poll; DESTRUCTIVE: discards sync cursors.
- [Update account sync config](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_accounts/update-account-sync-config.md): Set the account's weekly sync schedule: the timezone, the allowed per-weekday time windows, and per-track cadence entries. Replaces the stored sync_config wholesale (send the full desired config, not a…
- [Visit profile](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_accounts/visit-profile.md): Visit a target person's profile from this account (warm-up / signal action). Outward action on LinkedIn.
- [Follow LinkedIn member](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_accounts/follow-linkedin-member.md): Follow a LinkedIn member as this account, so their posts reach its feed. One-way and needs no relationship: you can follow anyone whose profile allows it, connected or not, which makes it a common warmu…
- [Unfollow LinkedIn member](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_accounts/unfollow-linkedin-member.md): Stop following a LinkedIn member as this account, the inverse of follow_linkedin_member. NOT a disconnect: it leaves a 1st-degree connection intact and only stops that member's posts reaching the feed,…
- [Search LinkedIn auto-scrape results](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_auto_scrape_results/search-linkedin-auto-scrape-results.md): Read the leads a collector has captured: one row per unique person or company, deduped across every run, each carrying flat identifiers plus the latest payload (name, headline, location, industry). Use…
- [Search LinkedIn auto-scrape runs](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_auto_scrape_runs/search-linkedin-auto-scrape-runs.md): List executions of the collectors: one row per pass of one auto-scrape page loop, with its page progress and its delta (new_count, seen_count, enrolled_count). Use for: the history of one job (filter li…
- [Get LinkedIn auto-scrape run](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_auto_scrape_runs/get-linkedin-auto-scrape-run.md): Fetch one run by sid: the poll handle after run_linkedin_auto_scrape_now. Read status, page_cursor and pages_applied for progress, new_count against enrolled_count for how much of the delta reached the…
- [Create LinkedIn auto-scrape](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_auto_scrapes/create-linkedin-auto-scrape.md): Save a scraping source as a collector and start it. Give the source EXACTLY one way: a bare url (people and company searches only) or the pair source_method plus source_input. Anything else is 422.
- [Search LinkedIn auto-scrapes](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_auto_scrapes/search-linkedin-auto-scrapes.md): List the team's collectors: saved jobs that paginate one LinkedIn or Sales Navigator list surface on a cadence and file deduped leads. Use for: which collectors are live or paused and why (status, pause…
- [Get LinkedIn auto-scrape](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_auto_scrapes/get-linkedin-auto-scrape.md): Fetch one collector by sid: status and paused_reason, next_run_at and last_run_at, runs_count and total_new_results, and mass_action_sid (null = collect-only). include: linkedin_account (the executor ro…
- [Delete LinkedIn auto-scrape](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_auto_scrapes/delete-linkedin-auto-scrape.md): Retire a collector for good: soft-delete, so no further run is ever minted and a run in flight abandons at its next page boundary. Runs and collected leads are retained for audit and stay readable by si…
- [Update LinkedIn auto-scrape](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_auto_scrapes/update-linkedin-auto-scrape.md): Patch a collector. Only title and replay_frequency are writable, and at least one must be sent (else 422 nothing_to_update). The source is immutable by design: a different source is a different collecto…
- [Pause LinkedIn auto-scrape](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_auto_scrapes/pause-linkedin-auto-scrape.md): Freeze recurrence: status becomes paused with paused_reason 'manual' and next_run_at is cleared, so no new run is minted. A run already in flight FINISHES (pausing never abandons it). Idempotent. Use to…
- [Resume LinkedIn auto-scrape](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_auto_scrapes/resume-linkedin-auto-scrape.md): Re-arm a paused collector: status becomes active, paused_reason clears, consecutive_failures resets to 0 and next_run_at is set to now, so the next scheduler tick mints a run. Works on any paused job, i…
- [Run LinkedIn auto-scrape now](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_auto_scrapes/run-linkedin-auto-scrape-now.md): Mint a manual run immediately, off schedule, and return its run_sid in result. Asynchronous: a worker drives the page loop, so poll get_linkedin_auto_scrape_run for status, new_count and enrolled_count.…
- [Link LinkedIn auto-scrape to a mass-action](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_auto_scrapes/link-linkedin-auto-scrape-to-a-mass-action.md): Wire this collector to a mass-action: from the next run on, every newly discovered lead is appended to that run as one item, which is how collection turns into outreach. Author the run FIRST on the mass…
- [Unlink LinkedIn auto-scrape from its mass-action](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_auto_scrapes/unlink-linkedin-auto-scrape-from-its-mass-action.md): Cut the outreach wire: clear mass_action_sid so the collector goes back to collect-only from the next run. This does NOT stop the mass-action. Leads already enrolled keep running, and stopping them is d…
- [Get latest LinkedIn benchmark](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_benchmarks/get-latest-linkedin-benchmark.md): Return the most recent platform benchmark row (largest period_start < today). Platform-GLOBAL: every team reads the same weekly row. No parameters. Use to compare an account or fleet against the market…
- [Get my latest connection invitations](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_connection_invitations/get-my-latest-connection-invitations.md): Always-fresh head read of pending inbound invitations: refresh the newest from LinkedIn in-request (§5.8), then return the last N (received_at DESC). The first page (cursor null) triggers the refresh; c…
- [Connection invitations metrics](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_connection_invitations/connection-invitations-metrics.md): Period-bound aggregates over one account's invitations. Requires period {from,to} and filter.linkedin_account_sid (.eq or .in) - that is the ONLY filter axis the aggregation applies, unlike search. Retu…
- [Search connection invitations](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_connection_invitations/search-connection-invitations.md): List inbound LinkedIn connection invitations we received, with filters (including an exact-match note filter; there is no free-text q on this entity), sorting and cursor pagination. Pending rows have re…
- [Sync connection invitations](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_connection_invitations/sync-connection-invitations.md): Kick off a fresh inbound-invitations sync for one account by inserting a sync_run. ASYNC: returns pending refs to poll or await the linkedin-connection-invitations.sync-completed webhook.
- [Accept connection invitation](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_connection_invitations/accept-connection-invitation.md): Accept one inbound connection invitation (outward action). On terminal success the invitation row is soft-deleted (removal_kind=accepted) and a linkedin-connections row is created for the new 1st-degree…
- [Ignore connection invitation](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_connection_invitations/ignore-connection-invitation.md): Ignore one inbound connection invitation (outward action). On terminal success the invitation row is soft-deleted (removal_kind=ignored); no connection is created. Identify the invitation by its ln_ci_…
- [Get my latest connection requests](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_connection_requests/get-my-latest-connection-requests.md): Always-fresh head read of pending outbound requests: refresh the newest from LinkedIn in-request (§5.8), then return the last N (sent_at DESC). The first page (cursor null) triggers the refresh; continu…
- [Connection requests metrics](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_connection_requests/connection-requests-metrics.md): Period-bound aggregates over one account's sent requests. Requires period {from,to} and filter.linkedin_account_sid (.eq or .in) - that is the ONLY filter axis the aggregation applies, unlike search. Re…
- [Search connection requests](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_connection_requests/search-connection-requests.md): List outbound LinkedIn connection requests (invitations we sent) with filters, sorting, cursor pagination and full-text q over the note. Pending rows have removal_kind IS NULL; terminal rows are accepte…
- [Send connection request](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_connection_requests/send-connection-request.md): Send one outbound LinkedIn connection request (outward action). profile_id is the target URN (ln_id OR sn_id). Server-side checks run first: the daily send limit, the premium-aware note cap (200 free /…
- [Sync connection requests](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_connection_requests/sync-connection-requests.md): Refresh the outbound sent-invitations snapshot for one account by inserting a sync_run (upsert-only). ASYNC: returns pending refs to poll or await the linkedin-connection-requests.sync-completed webhook.
- [Withdraw connection request](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_connection_requests/withdraw-connection-request.md): Withdraw a pending outbound connection request (outward, destructive). Dispatches the withdraw-invitation browser verb (networking_general bucket); on terminal success the row is soft-deleted (removal_k…
- [Check connection degree](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_connections/check-connection-degree.md): Probe one contact's current connection degree (1st / 2nd / 3rd / 4_plus) from a managed account, and actualize a stale stored row: a live connection whose degree is no longer 1st is soft-deleted (remova…
- [Get my latest connections](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_connections/get-my-latest-connections.md): Always-fresh head read: refresh the newest connections from LinkedIn in-request (§5.8), then return the last N (connected_at DESC) with a counts block. The first page (cursor null) triggers the refresh;…
- [LinkedIn connections metrics](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_connections/linkedin-connections-metrics.md): Period-bound aggregates over a filtered connection set. Requires period {from,to} (≤ 90 days). Returns connections_growth, connections_removed, net_growth, reply_rate_within_connections, dormant_connect…
- [Search LinkedIn connections](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_connections/search-linkedin-connections.md): List an account's 1st-degree LinkedIn connections with filters, sorting, cursor pagination and full-text q over the contact name. Live rows by default (deleted_at.is_null:true); pass is_null:false for c…
- [Sync my connections](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_connections/sync-my-connections.md): Kick off a full background connections sync for one account by inserting a sync_run (upsert-only: new/updated rows only, no removal detection). ASYNC: returns pending refs to poll or await the linkedin-…
- [Remove connection](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_connections/remove-connection.md): Disconnect a 1st-degree connection on LinkedIn (outward, destructive). Dispatches the remove-connection browser verb (networking_general bucket); on terminal success the local row is soft-deleted (remov…
- [Get my latest LinkedIn conversations](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_conversations/get-my-latest-linkedin-conversations.md): Always-fresh head read of the basic-LinkedIn-messenger thread list for one account (§5.8 foreground refresh, then the last N threads from the refreshed DB, last_activity_at DESC). Never serves stale dat…
- [Get my latest Sales Navigator conversations](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_conversations/get-my-latest-sales-navigator-conversations.md): Sales Navigator variant of get_my_latest_linkedin_conversations: always-fresh head read of the SN thread list for one account (§5.8 refresh-then-return). Same hard-429 guards; returns messenger_type='sa…
- [Get LinkedIn conversations metrics](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_conversations/get-linkedin-conversations-metrics.md): Period-bound conversation aggregates for one account (new_conversations_count, active_count) with an optional group_by axis. Requires period {from,to} (≤ 90 days) and filter.linkedin_account_sid - that…
- [Search LinkedIn conversations](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_conversations/search-linkedin-conversations.md): List LinkedIn message threads for the team across both messenger surfaces (basic LinkedIn + Sales Navigator) with operator-object filters (account, contact ids, messenger_type, event-count, activity / m…
- [Sync my LinkedIn conversations](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_conversations/sync-my-linkedin-conversations.md): Start a background sync run that reconciles the full basic-LinkedIn-messenger thread directory for one account. ASYNC: returns a pending ref (sync_run_sid) to poll; changed threads have their messages p…
- [Sync my Sales Navigator conversations](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_conversations/sync-my-sales-navigator-conversations.md): Start a background sync run that reconciles the full Sales Navigator thread directory for one account. ASYNC: returns a pending ref to poll. Separate sync_type and cadence from the basic-LinkedIn sync s…
- [Get LinkedIn conversation](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_conversations/get-linkedin-conversation.md): Fetch one conversation by sid: the stored row including the denormalized participants list. Stored-DB read: no plugin call, no limit spend.
- [Add conversation participants](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_conversations/add-conversation-participants.md): Add one or more members to an existing thread on LinkedIn (outward action). Pass the conversation sid + participant_ln_ids (1..20 member URNs); a 1:1 thread is promoted to a group. Returns the updated c…
- [Mark conversation read](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_conversations/mark-conversation-read.md): Mark a conversation thread as read on LinkedIn's side (outward action). LinkedIn-side effect only, no stored read-state changes; the audit rides an activity-log row. Idempotent; safe to retry.
- [Mark conversation unread](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_conversations/mark-conversation-unread.md): Mark a conversation thread as unread on LinkedIn's side (outward action), the hand-back-to-human signal after an agent triaged a thread. LinkedIn-side effect only; no stored read-state changes.
- [Mute conversation](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_conversations/mute-conversation.md): Mute or unmute one thread's notifications on LinkedIn (outward action). Pass the conversation sid + mute (true = mute, default; false = unmute); the change is dispatched to LinkedIn and mirrored on the…
- [Remove conversation participants](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_conversations/remove-conversation-participants.md): Remove one or more members from a group thread on LinkedIn (outward action). Pass the conversation sid + participant_ln_ids (1..20 member URNs to remove). Returns the updated conversation.
- [Rename conversation](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_conversations/rename-conversation.md): Rename a group thread on LinkedIn (outward action). Pass the conversation sid + the new title (1..256 chars). Returns the updated conversation.
- [Execute custom LinkedIn request (escape hatch)](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_custom_requests/execute-custom-linkedin-request-escape-hatch.md): ESCAPE HATCH: issue one arbitrary LinkedIn HTTP call (url + GET/POST + headers/body) under a chosen OWN account, for endpoints the typed methods do not cover. May be a read or an action (apply to a job,…
- [Enrich company lite profile](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_enrichment/enrich-company-lite-profile.md): The cheap company read: id, vanity, name and logo, nothing else. Deliberately sparse, the company twin of the lite person profile. Use it to confirm a company exists and to pin its identifiers before jo…
- [Enrich company posts](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_enrichment/enrich-company-posts.md): The company page's own feed, newest-first: the company-side twin of person-posts (author = the company page). Addressed by NUMERIC company id, nested: {company:{company_ln_id}}. If all you have is a com…
- [Enrich company profile](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_enrichment/enrich-company-profile.md): One company page's own data: name, industry, size, HQ, about, website, followers. URL-addressed (ledgered input_kind='url'). cached 7d. To LIST a company's people use scraping (company-employees / compa…
- [Resolve company vanity](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_enrichment/resolve-company-vanity.md): Resolve a numeric LinkedIn company id to its vanity slug. Its own method because this resolution is the single most expensive company request LinkedIn serves: a ~164KB organizational-page download, the…
- [Enrich activity URN by URL](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_enrichment/enrich-activity-urn-by-url.md): Resolve any linkedin.com post URL (feed permalink, /posts/ slug, shortlink) to its stable activity URN (urn:li:activity:…). The URN never changes, so this is a cacheable enrichment lookup at cached 7d.…
- [Enrich person basic profile](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_enrichment/enrich-person-basic-profile.md): The middle person read, between the lite identity stub and the full dossier: name PARTS (first / last, which no other read splits out), headline, country and display location, profile and background ima…
- [Enrich person certifications](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_enrichment/enrich-person-certifications.md): Licenses and certifications from the target profile: issuing authority, license number, validity window. A qualification and compliance signal for recruiting and technical ICP fit. cached 7d. Most profi…
- [Enrich person comment activity](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_enrichment/enrich-person-comment-activity.md): The target's recent comments across OTHER people's posts (activity feed, Comments tab): where the target spends attention, and warm entry points for an opener. Each item carries the PARENT POST too, so…
- [Enrich person contact info](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_enrichment/enrich-person-contact-info.md): Contact details for ONE person: email, phones (typed, so HOME/WORK is kept, unlike the lossy flat `phone` on person-full-profile), websites and twitter handles. Cached 24h. IMPORTANT: LinkedIn reveals c…
- [Enrich person education](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_enrichment/enrich-person-education.md): Education history only, a subset projection of the full-profile wire call (NOT a stub: shares get-full-profile, no dedicated verb). cached 7d under its own method key (a cached full profile does NOT sat…
- [Enrich person experience](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_enrichment/enrich-person-experience.md): Complete, paginated work history ("Show all experiences"), unlike the truncated head on full-profile. One call = one page; loop cursor until paging.next_page_cursor is absent. cached 7d. A public_identi…
- [Enrich person featured](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_enrichment/enrich-person-featured.md): The Featured section: what the target chose to pin (posts, links, media). Small, cheap, high-signal for personalization: pinned content is what the person WANTS noticed. cached 7d. Not paginated. A publ…
- [Enrich person full profile](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_enrichment/enrich-person-full-profile.md): The complete person dossier: identity, headline/position/company, location, about, follower/connection counts, premium/verification flags, plus truncated heads of experience/education/skills/recent post…
- [Enrich person interests](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_enrichment/enrich-person-interests.md): ONE tab of the Interests section per call: top_voices (the default), companies, groups, newsletters or schools. Cheap ICP-fit and conversation-hook signal. cached 7d, paginated. The wire pages a single…
- [Enrich person languages (not shipped)](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_enrichment/enrich-person-languages-not-shipped.md): ⛔ NOT SHIPPED YET. Contract locked, capability not built; returns not_implemented, do not retry. The Languages section: spoken languages with self-declared proficiency. Cheap localization signal: write…
- [Enrich person lite profile](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_enrichment/enrich-person-lite-profile.md): Cheapest person read: existence check + full identifier resolution. THE tool for turning a vanity slug (/in/…) or a bare URN into the canonical identifier quad (ln_member_id + both URNs + nickname) that…
- [Enrich person posts](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_enrichment/enrich-person-posts.md): Posts authored or reshared by the target, newest-first: the personalization goldmine before outreach. Reshares carry the original in reshared_post; created_at is ISO 8601. cached 7d. This is the target'…
- [Enrich person reaction activity](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_enrichment/enrich-person-reaction-activity.md): The target's recent reactions on OTHER people's posts (activity feed, Reactions tab): topical interest signal, cheaper to act on than comments. Each item carries the reaction type, when they reacted, an…
- [Enrich person recommendations](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_enrichment/enrich-person-recommendations.md): Recommendations on the target profile: who vouches for them and in what words. `direction` picks received (the default, what LinkedIn opens on) or given; these are two SEPARATE reads of the same screen,…
- [Enrich person services](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_enrichment/enrich-person-services.md): The "Providing services" marketplace page of one service-provider profile: business name, pricing line, page URL and the standardized services they list. Complements scraping-side search-service-provide…
- [Enrich person skills](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_enrichment/enrich-person-skills.md): Complete, paginated skills list ("Show all skills") with endorsement counts (skill_id is the endorse handle). cached 7d. Use to see/reason over skills; to simply ENDORSE, use linkedin-accounts.endorse-s…
- [Enrich post details](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_enrichment/enrich-post-details.md): One post's own data by its urn: full text, author, media, engagement counters, per-reaction breakdown, is_reshare with the original post embedded. LIVE since 2026-08-14 (node get-post). Accepts post_urn…
- [Get my latest followers](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_followers/get-my-latest-followers.md): Always-fresh head read of the followers list: refresh the newest from LinkedIn in-request (§5.8), then return the last N (created_at DESC) with a counts block. The first page (cursor null) triggers the…
- [LinkedIn followers metrics](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_followers/linkedin-followers-metrics.md): Period-bound audience aggregates over a filtered follower set. Requires period {from,to}. Returns followers_growth, follower_to_connection_conversions and connected_follower_share. Optional filter and a…
- [Search LinkedIn followers](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_followers/search-linkedin-followers.md): List stored followers of team accounts with filters, sorting, cursor pagination and full-text q over the follower name. Returns a counts block. include[] can eager-load linkedin_account plus the funnel…
- [Download message attachment](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_messages/download-message-attachment.md): Download one inbound attachment of a basic-messenger message, returned inline as a base64 data_url (nothing is persisted, no row changes). This verb is addressed by RAW LinkedIn ids, not by our message…
- [Download Sales Navigator attachment](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_messages/download-sales-navigator-attachment.md): Sales Navigator variant of download_linkedin_message_attachment: one inbound attachment of an SN message, inline as a base64 data_url. Same raw-id addressing, one field fewer (the SN wire verb takes no…
- [Get my latest LinkedIn messages](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_messages/get-my-latest-linkedin-messages.md): Always-fresh head read of ONE basic-messenger thread (§5.8 refresh of that conversation from LinkedIn, then the last N messages, sent_at DESC). Never stale: it 429s with bucket_saturated / sync_in_progr…
- [Get my latest Sales Navigator messages](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_messages/get-my-latest-sales-navigator-messages.md): Sales Navigator variant of get_my_latest_linkedin_messages: always-fresh head read of ONE SN thread's messages (§5.8 refresh-then-return). Requires a messenger_type='sales_navigator' conversation; same…
- [Get LinkedIn messages metrics](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_messages/get-linkedin-messages-metrics.md): Period-bound message aggregates for one account (reply_rate_pct, avg_time_to_reply_seconds, avg_thread_depth) with an optional group_by axis. Requires period {from,to} (≤ 90 days) and filter.linkedin_ac…
- [Search LinkedIn messages](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_messages/search-linkedin-messages.md): List LinkedIn messages (basic DM + Sales Navigator + InMail) with operator-object filters (account, conversation, channel, direction, contact ids, date ranges) and FULLTEXT q over body + subject. Suppor…
- [Send LinkedIn message](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_messages/send-linkedin-message.md): Send one outbound regular LinkedIn DM on the basic messenger (outward action). Reply to an existing thread via linkedin_conversation_sid, or open a new thread to a 1st-degree connection via ln_id / sn_i…
- [Send LinkedIn InMail](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_messages/send-linkedin-inmail.md): Send one premium InMail to a person (outward action). Person-addressed only via ln_id / sn_id, subject required (≤ 200), body ≤ 1900. Guards: in-flight dedup, send_inmails daily cap, Premium guard, InMa…
- [Send Sales Navigator message](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_messages/send-sales-navigator-message.md): Send one Sales Navigator message (outward action): continue an existing SN thread via linkedin_conversation_sid (messenger_type=sales_navigator), or open a new SN thread via ln_id / sn_id. Body ≤ 8000.…
- [Send LinkedIn voice message](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_messages/send-linkedin-voice-message.md): Send one voice note on the basic LinkedIn messenger (outward action). audio arrives as a https:// url or base64 (any common format) and is normalized server-side to AAC/m4a, hard-capped at 60 s. Same gu…
- [Start group conversation](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_messages/start-group-conversation.md): Start a new multi-attendee (group) chat on the basic messenger and send an opening message (outward action). Provide the executor account, 2..20 attendee URNs and the opening body (1..8000 chars, option…
- [React to message](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_messages/react-to-message.md): Add or remove an emoji reaction on one stored message on LinkedIn (outward action). Pass the message sid + a reaction_type; the reaction is dispatched to LinkedIn and mirrored onto the stored row. Set r…
- [Create LinkedIn comment](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_posting/create-linkedin-comment.md): Leave ONE outbound comment on any LinkedIn post, addressed by its post-thread URN in entity_urn (wire create-comment): member posts by urn:li:activity:<id>, company-page posts and newsletter issues by u…
- [Create LinkedIn post](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_posting/create-linkedin-post.md): Publish ONE feed post under the account's own identity (wire create-post). Public and irreversible through this API: there is no delete verb here. Identity-bound: linkedin_account_sid REQUIRED, spends t…
- [React to LinkedIn post](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_posting/react-to-linkedin-post.md): Leave OUR reaction on any LinkedIn post, addressed by its post-thread URN in entity_urn (wire create-reaction): member posts by urn:li:activity:<id>, company-page posts and newsletter issues by urn:li:u…
- [Scrape company decision makers](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_scraping/scrape-company-decision-makers.md): Sales Navigator’s decision-makers panel for ONE company: the bounded, seniority-weighted leadership/buying-committee list SN computes. SN-capable executor required.
- [Scrape company employees](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_scraping/scrape-company-employees.md): List the people currently working at ONE company (the company page’s "employees" people-search, page-numbered). Heavy, page-numbered list.
- [Scrape post comments](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_scraping/scrape-post-comments.md): Direct LinkedIn read (bypasses our DB): one page of the COMMENTS on ONE post, live. This is the only comments read there is - a row carries the comment AND the person who wrote it (content, posted_at, c…
- [Scrape post reactors](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_scraping/scrape-post-reactors.md): Direct LinkedIn read (bypasses our DB): live pull of who is reacting to ONE post right now, as transient reactor objects with normalized reaction_type (MAYBE → like + WARN), annotated with is_own and is…
- [Scrape post resharers](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_scraping/scrape-post-resharers.md): Direct LinkedIn read (bypasses our DB): live pull of the profiles that RESHARED one post, the third and typically highest-intent leg of the engagement trio. Same targeting (post URL or activity URN); is…
- [Look up LinkedIn facet id](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_scraping/look-up-linkedin-facet-id.md): Facet-id typeahead for the REGULAR (non Sales Navigator) search: turn a human term ("United States", "SaaS", "Acme") into the id a filter member needs. One type per call, and the type picks the member:…
- [Look up Sales Navigator facet id](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_scraping/look-up-sales-navigator-facet-id.md): Sales Navigator facet-id typeahead: resolve one SN facet (type) into the opaque ids the SN search filters need. type is a node salesApiFacetTypeahead kind passed through verbatim; the seven text facets…
- [Scrape LinkedIn company search](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_scraping/scrape-linkedin-company-search.md): One page of a regular LinkedIn company search, addressed EITHER by `filters` (keywords, geo ids, industry ids, headcount buckets) OR by a pasted /search/results/companies/ `url`: exactly one of the two,…
- [Scrape LinkedIn Learning course search](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_scraping/scrape-linkedin-learning-course-search.md): One page of a LinkedIn LEARNING course search, the sixth row kind here: `filters` OR a pasted /search/results/learning/ `url` (that screen, NOT /courses/), exactly one of the two. filters is a REQUIRED…
- [Scrape event search](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_scraping/scrape-event-search.md): One page of a LinkedIn EVENT search. `filters` carries keywords and NOTHING else (this engine has no location, date, type or organizer facet, and any other key is refused by name), so a pasted /search/r…
- [Scrape group search](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_scraping/scrape-group-search.md): One page of a LinkedIn GROUP search, the fifth row kind on this surface. `filters` carries keywords and nothing else, exactly like the events search, so a pasted /search/results/groups/ `url` is the onl…
- [Scrape job-posting search](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_scraping/scrape-job-posting-search.md): One page of a LinkedIn JOB-POSTING search, addressed EITHER by `filters` (keywords is REQUIRED here, which no other engine on this surface demands) OR by a pasted /jobs/search-results/ `url`, which is t…
- [Scrape LinkedIn people search](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_scraping/scrape-linkedin-people-search.md): One page of a regular LinkedIn people search, addressed EITHER by `filters` OR by a pasted search `url`: exactly one of the two, never both, never neither. Use filters when the agent composes the search…
- [Scrape post search](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_scraping/scrape-post-search.md): LinkedIn content search: find POSTS by keywords, recency or author. The discovery front door for post-engagement plays (feed the returned post_ln_id into the commenters / reactors / resharers tools). Ad…
- [Scrape LinkedIn product search](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_scraping/scrape-linkedin-product-search.md): One page of a LinkedIn PRODUCT search, the seventh row kind here: `filters` OR a pasted /search/results/products/ `url`, exactly one of the two. filters is a REQUIRED keywords plus a one-way free_versio…
- [Scrape Sales Navigator company search](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_scraping/scrape-sales-navigator-company-search.md): One page of a Sales Navigator ACCOUNT search, the one engine here that filters on annual revenue, company and per-department headcount growth, department headcount, follower buckets, Fortune tier and bu…
- [Scrape Sales Navigator people search](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_scraping/scrape-sales-navigator-people-search.md): One page of a Sales Navigator people search: richer facets than the regular engine (seniority, function, tenure, headcount, company type), no commercial-use limit, SN URNs (sn_id) on the rows. Addressed…
- [Scrape LinkedIn school search](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_scraping/scrape-linkedin-school-search.md): One page of a LinkedIn SCHOOL search, the eighth row kind here: `filters` OR a pasted /search/results/schools/ `url`, exactly one of the two. filters is a REQUIRED keywords and NOTHING else, the same on…
- [Scrape service-provider search](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_scraping/scrape-service-provider-search.md): One page of LinkedIn's service-provider marketplace (freelancers and agencies), addressed EITHER by `filters` (keywords, LinkedIn's own numeric service-category and geo ids, connection degree, profile l…
- [Scrape similar companies](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_scraping/scrape-similar-companies.md): LinkedIn’s "similar companies / pages people also viewed" list for ONE target company: lookalike account expansion. One-shot list.
- [Scrape similar profiles](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/linkedin/linkedin_scraping/scrape-similar-profiles.md): LinkedIn’s "people also viewed" browsemap for ONE seed profile: lookalike expansion from a known-good persona. IMPORTANT: address by profile.nickname (the vanity slug) ONLY, because the wire navigates b…
- [Lend an account to another workspace](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/account_shares/lend-an-account-to-another-workspace.md): Lend ONE of your connected accounts to another workspace, temporarily and revocably. This is a loan, not a handover: permanent ownership transfer has no MCP tool at all. Target exactly one of to_email (…
- [List received account shares](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/account_shares/list-received-account-shares.md): List the account shares your team RECEIVED: accounts on loan TO you. Reach for this whenever the question is about a BORROWED account (what did we borrow, from whom, until when, is it still active), and…
- [Recall a lent-out account](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/account_shares/recall-a-lent-out-account.md): Take a lent-out account back. Owner side, no holder consent. Target EXACTLY ONE of sid (ac_sh_) or filter; neither or both is 422 on sid_or_filter. FILTER MODE fans out over the loans you ISSUED, the se…
- [Return a borrowed account](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/account_shares/return-a-borrowed-account.md): Give a borrowed account back early. Holder side. Same shape as recall_account_share: EXACTLY ONE of sid (ac_sh_) or filter, filter mode server-pinned to status active, drained INLINE at most 100 shares…
- [Search issued account shares](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/account_shares/search-issued-account-shares.md): List the account shares your team ISSUED: accounts you lent OUT to another workspace. Sharing is TEMPORARY and revocable; permanent ownership transfer is a web-app-only flow with no MCP tool, so never o…
- [Create API key](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/api_keys/create-api-key.md): Issue a new API key and return the full secret in the create envelope's plaintext_token EXACTLY ONCE. It is unrecoverable, so hand it to the user immediately and never log or echo it; if lost, rotate. C…
- [API key metrics](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/api_keys/api-key-metrics.md): Period-bound counts of the team's keys by status, plus issuance / expiry tallies inside the window (created_in_period, expired_in_period). Requires period {from, to}. Optional filter. Counts key rows, n…
- [Search API keys](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/api_keys/search-api-keys.md): List the team's API keys for an access audit: which keys exist, what each can do (permissions), their status, when each was last_used_at and when each expires. Filter by status for live vs dead keys, by…
- [Get API key](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/api_keys/get-api-key.md): Fetch a single API key by sid, with optional metrics include. Returns token_prefix + token_last4 for display; the secret is unrecoverable (use rotate_api_key to mint a new one).
- [Revoke API key](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/api_keys/revoke-api-key.md): Revoke a key (simple soft-delete): status=revoked, deleted_at set. Verify rejects it from the next request (cache invalidated). Irreversible: a revoked key never re-activates; issue a fresh one. Idempot…
- [Update API key](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/api_keys/update-api-key.md): Partial update of name / permissions only (the key's identity and secret are untouched; use rotate_api_key to change the secret). permissions is a FULL replacement. When the caller is a parent api_key,…
- [Rotate API key](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/api_keys/rotate-api-key.md): Swap the key's secret IN PLACE and return the new plaintext in result.plaintext_token EXACTLY ONCE: hand it to the user, never log it, unrecoverable. The key's sid / name / permissions / expires_at are…
- [List payment methods](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/billing_payment_methods/list-payment-methods.md): List the saved cards / PayPal / wallets for the active workspace's paying user (proxied live from Paddle). The list is re-sorted so the billing card is items[0]; is_default:true is the card that last bi…
- [Get add-card link](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/billing_payment_methods/get-add-card-link.md): Return a temporary Paddle Customer Portal deep link to add or replace a card for the workspace's applied subscription. This is the ONLY way to add a card: Paddle has no add-card API; the user enters car…
- [Delete payment method](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/billing_payment_methods/delete-payment-method.md): Remove a saved payment method from the workspace's paying user's Paddle customer (proxies Paddle DELETE; no local row, no cascade). DANGEROUS. Search first and, if the method is is_default:true (the bil…
- [Search billing products](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/billing_products/search-billing-products.md): List the Paddle-synced product catalog (the base plan + add-ons) with filtering, sorting and cursor pagination. Filter by type to split plan vs add-on, is_active for the live catalog, or q for an infix…
- [Create subscription checkout](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/billing_subscriptions/create-subscription-checkout.md): Start a self-serve purchase of a subscription. DANGEROUS (charges money): it pre-creates a billed Paddle transaction and returns a hosted checkout_url the buyer pays in the Paddle overlay (server-side p…
- [Search billing subscriptions](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/billing_subscriptions/search-billing-subscriptions.md): List the caller's billing subscriptions: the ones they bought (owner = caller, including floating subscriptions applied to no team) plus the one applied to a team they can read. Filter by status, team_s…
- [Get billing subscription](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/billing_subscriptions/get-billing-subscription.md): Fetch a single billing subscription by sid, with optional includes (price, product, team, latest_transactions).
- [Add subscription add-on](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/billing_subscriptions/add-subscription-add-on.md): Add a recurring add-on item to the SAME subscription (one Paddle PATCH, one prorated charge). DANGEROUS: charges the owner's card (prorated); server-side confirm gate applies. Idempotent per request_id:…
- [Apply subscription to team](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/billing_subscriptions/apply-subscription-to-team.md): Apply a floating subscription (owned by the caller) to a team, activating its slots + limits there. Owner-only. DANGEROUS state change (server-side confirm gate); rejects with 409 if the team already ha…
- [Cancel subscription](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/billing_subscriptions/cancel-subscription.md): Cancel the subscription at the end of the current period (terminal). DANGEROUS: the team loses capacity when the period ends, though data is retained and there is no immediate charge or refund. Server-s…
- [Change subscription](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/billing_subscriptions/change-subscription.md): Commit a quantity / bracket-price change. DANGEROUS: an UPGRADE charges the owner's card immediately (prorated); a downgrade applies next period (no immediate charge). Server-side preview→commit gate ap…
- [Get update-payment-method link](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/billing_subscriptions/get-update-payment-method-link.md): Return a short-lived Paddle portal deep link to update the card for this subscription (the typical past_due recovery path). No charge, mutates nothing on our side. Requires billing.manage.
- [Pause subscription](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/billing_subscriptions/pause-subscription.md): Pause the subscription effective the next billing period. DANGEROUS state change (server-side confirm gate); while paused the applied team is gated like suspended, slots/data retained, billing stops. No…
- [Preview subscription change](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/billing_subscriptions/preview-subscription-change.md): Read-only proration preview for a quantity / bracket-price change BEFORE committing. Calls Paddle Pricing Preview and returns the immediate charge (upgrade) or next-period credit (downgrade), the resolv…
- [Remove subscription add-on](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/billing_subscriptions/remove-subscription-add-on.md): Remove an add-on item from the subscription, effective next period (no refund, no immediate charge). DANGEROUS state change (server-side confirm gate). Requires billing.manage.
- [Resume subscription](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/billing_subscriptions/resume-subscription.md): Resume a paused subscription; billing continues from the next period and the applied team re-derives active. DANGEROUS state change (server-side confirm gate). No charge. The committed status arrives vi…
- [Unapply subscription](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/billing_subscriptions/unapply-subscription.md): Detach a subscription from its team, returning it to floating on the buyer's balance. DANGEROUS: removes the team's capacity (the team goes suspended if this was its only applied subscription); does NOT…
- [Billing transaction metrics](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/billing_transactions/billing-transaction-metrics.md): Period-bound money sums over the caller's transactions. Requires period {from,to}. Money never crosses currencies; every sum lives inside a per-currency by_currency entry keyed by ISO 4217. Answers 'how…
- [Search billing transactions](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/billing_transactions/search-billing-transactions.md): List billing transactions (invoices / charges) for the caller: one row per Paddle transaction, newest first. Filter by status / origin / collection_mode / currency / billed_at window, or locate one by i…
- [Get billing transaction](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/billing_transactions/get-billing-transaction.md): Fetch a single billing transaction by sid, with optional subscription / owner / team includes. Returns the frozen items[] charge snapshot inline.
- [Get transaction invoice](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/billing_transactions/get-transaction-invoice.md): Fetch a temporary, time-limited download URL for this transaction's invoice PDF from Paddle (never stored on our side; expires ~1h). Works for self-serve card charges and sales-issued manual invoices. R…
- [Notifications metrics](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/notifications/notifications-metrics.md): Period-bound delivery-health aggregates over a filtered notification set: how many notifications were delivered, failed, and rate-limited in the window. Requires period {from,to}. Optional filter and a…
- [Search notifications](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/notifications/search-notifications.md): List notifications (email and in_app channels) for the team/user with filtering, sorting and cursor pagination: the user inbox ("what was sent to me?"), admin audit ("what did the system email Jane abou…
- [Get notification](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/notifications/get-notification.md): Fetch a single notification by sid: the rendered subject / body, delivery state, and failure reason if any. Useful in post-call analysis: follow a notification's event_sid back through observability to…
- [Dismiss notification](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/notifications/dismiss-notification.md): Dismiss a notification from the inbox: a soft-delete that sets deleted_at. DESTRUCTIVE (removes the row from inbox lists). It does NOT cancel in-flight delivery: if the delivery worker already picked th…
- [Search connected apps](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/oauth_authorizations/search-connected-apps.md): List the caller's connected apps (standing OAuth consent grants). Always scoped to the caller's own grants, never cross-user. Filter by status (active vs revoked history), oauth_client_sid, or team_scop…
- [Edit connected app](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/oauth_authorizations/edit-connected-app.md): Partial self-service edit of the grant's mutable fields WITHOUT re-running the browser consent: team_scope_mode, consented_team_sids (full-replace, non-empty when mode=selected), and permissions (full-r…
- [Disconnect app (revoke grant)](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/oauth_authorizations/disconnect-app-revoke-grant.md): Disconnect an app: flip the grant to status=revoked, clear its refresh credential, and cascade-revoke every installation token (all teams) in one transaction, so the agent is cut off immediately. The en…
- [Create OAuth client](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/oauth_clients/create-oauth-client.md): Register a new OAuth application; the server generates client_id. v1 clients are public/PKCE (no secret). A confidential client (fast-follow) returns client_secret in the create envelope ONCE. Tell the…
- [Search OAuth clients](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/oauth_clients/search-oauth-clients.md): List registered OAuth applications for the caller's team (plus platform clients when team_sid.is_null). Filter by status, client_id, registration_kind, is_confidential; include:["active_sessions"] to se…
- [Get OAuth client](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/oauth_clients/get-oauth-client.md): Fetch one OAuth client by sid. include:["active_sessions"] lists agents connected through it (requires sessions.view). client_secret is never returned on a read.
- [Delete OAuth client](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/oauth_clients/delete-oauth-client.md): Destructive. Soft-delete the client (sets deleted_at) and cascade-revoke every issued oauth session and grant, disconnecting all agents connected through this app immediately. The public OAuth flow reje…
- [Update OAuth client](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/oauth_clients/update-oauth-client.md): Partial update. Editable: name, redirect_uris, permissions, grant_types, status (redirect_uris / permissions full-replace). status:"disabled" cascade-revokes the client's oauth grants and issued tokens.…
- [Get observability request](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/observability_requests/get-observability-request.md): Fetch the full execution of one past MCP request by trace_id: spans, timings, status, the redacted input/output bodies, errors, emitted events, permission decisions, DB queries and the span tree. Read-o…
- [Get observability session](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/observability_requests/get-observability-session.md): Fetch the full tool-call history of one agent session by agent_session_id: total turns, total tool calls, and the per-turn tool-call breakdown. Read-only (Tempo + Loki facade). Use for post-mortems ("ex…
- [Search sessions](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/sessions/search-sessions.md): List sessions. Default scope is the caller's own active sessions ("Active sessions"); pass kind:{eq:"oauth"} for "Connected agents", or status to see revoked/expired history. Each row carries the derive…
- [Revoke session](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/sessions/revoke-session.md): End a session immediately: status active → revoked. The token is rejected from the next request (verifier cache flushed within 30-60s). This is the canonical "delete" for this entity; there is no delete…
- [Register SSL certificate](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/ssl_certificates/register-ssl-certificate.md): Register a custom domain as a certificate row in status='pending'. Does NOT start ACME; call issue_ssl_certificate next to begin the HTTP-01 flow. Idempotent on the domain natural key: an existing live…
- [Search SSL certificates](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/ssl_certificates/search-ssl-certificates.md): List the team's TLS certificates for custom email domains: which domains are registered, each status, issuer, issued_at, expires_at, and the redacted last_error for failures. Filter by status for live v…
- [Get SSL certificate](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/ssl_certificates/get-ssl-certificate.md): Fetch a single certificate by sid: status, issuer, validity window, redacted last_error, and the HTTP-01 challenge data while status='challenge'. Poll this after issue/renew until status flips to 'activ…
- [Delete SSL certificate](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/ssl_certificates/delete-ssl-certificate.md): Remove a custom domain's certificate. DESTRUCTIVE. Revokes the certificate at the CA (best-effort), removes the on-disk serving files, and soft-deletes the row. The CA-revoke and file-removal are extern…
- [Update SSL certificate](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/ssl_certificates/update-ssl-certificate.md): Metadata-only partial update. No certificate-affecting field is mutable here: domain, status, challenge, issuer and validity are driven by the ACME actions and jobs, never by update. v1 has no client-mu…
- [Issue SSL certificate](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/ssl_certificates/issue-ssl-certificate.md): Start the ACME HTTP-01 flow for a registered domain. ASYNC: synchronously requests authorization from Let's Encrypt, stores the token + key-authorization, flips status→challenge, and returns the challen…
- [Renew SSL certificate](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/ssl_certificates/renew-ssl-certificate.md): Force a re-issue of an existing certificate, ignoring the 30-day expiry window (operator-forced). ASYNC: same HTTP-01 path as issue: re-runs ACME on the same row, flips status→challenge, and on success…
- [Escalate to a human](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/support_requests/escalate-to-a-human.md): Hand the current issue to the human support team. Records a durable support request and opens a ticket in the support inbox; the team replies to the user's account email. Use when the user explicitly as…
- [Search support requests](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/support_requests/search-support-requests.md): List the team's support escalations with filtering, sorting and cursor pagination: the ops view ("what escalations are open?", "did this session already escalate?"). Returns a counts block of predicate…
- [Get support request](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/support_requests/get-support-request.md): Fetch a single support escalation by sid: the full body the team received, handoff state (intercom_ticket_id, handed_off_at) and the redacted delivery error if the handoff failed.
- [Invite team member](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/team_members/invite-team-member.md): Invite a person by email. Born status=invited, user_sid=null, with a one-time code (+7d expiry); dispatches the invite email. permissions is the explicit token list (expand a UI preset in code first); a…
- [Accept team-member invitation](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/team_members/accept-team-member-invitation.md): Accept a pending invite by its one-time code. Public REST: code-bearer, no team scope. Hashes the code, matches a live invited row with an unexpired code, flips invited → active, binds the authenticated…
- [Search team members](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/team_members/search-team-members.md): List members and pending invites in the caller's team: render the Members tab, find pending invites (filter.user_sid.is_null or filter.status.eq="invited"), or look up a member by email (q). include:["u…
- [Remove team member](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/team_members/remove-team-member.md): Remove a pending invite OR kick an active member: one tool, soft-delete. DESTRUCTIVE. The structural owner is protected (409 conflict, owner_cannot_be_removed); move ownership via transfer_team_ownershi…
- [Update team member](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/team_members/update-team-member.md): Re-scope an existing member: replace permissions and/or account_sids. email / status / user_sid / team_sid are read-only (rejected silently). At least one field required. Updating the owner's permission…
- [Resend team-member invitation](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/team_members/resend-team-member-invitation.md): Re-roll the one-time code on a pending invite, push its expiry (+7d), and re-send the invite email. Only valid on a status=invited row (else 409 invalid_transition).
- [Create team](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/teams/create-team.md): Create a new workspace. The caller becomes the owner AND the first member; the free "Sandbox" plan (forever free, 1 account slot, no card) is applied automatically where the owner does not already run a…
- [Search teams](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/teams/search-teams.md): List the caller's teams ("my workspaces"): teams they are a member of, plus teams they own. Filter by status to find suspended workspaces, or by subscription_sid.is_null for teams with no capacity. q do…
- [Get team](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/teams/get-team.md): Fetch a single team by sid, with optional includes (applied subscription, owner, member counts).
- [Delete team](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/teams/delete-team.md): Cascade soft-delete a workspace and its owned rows (members, keys, sessions, oauth clients, certs). Owner-only. DESTRUCTIVE. Blocked (409 delete_blocked) while a paid applied subscription is live. Unapp…
- [Update team](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/teams/update-team.md): Rename a team or edit its config. Only name / config are mutable; owner_user_sid (transfer-ownership), status (derived), subscription_sid (apply/unapply) and limits (system) are read-only and silently r…
- [Transfer team ownership](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/teams/transfer-team-ownership.md): Move structural ownership of the team to another active member. Owner-only (an admin cannot transfer). Transferring to the current owner is a no-op. This is the only way to change owner_user_sid, and th…
- [Get current user](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/users/get-current-user.md): Return the authenticated user's own profile: the JWT subject, self only (no {sid} form). include[]=default_team hydrates the working team; include[]=accessible_teams returns the owner + active-membershi…
- [Update current user](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/id/users/update-current-user.md): Patch the authenticated user's own profile: first_name / last_name / avatar_url / phone / timezone / country / config only. email (change-email flow), password (change-password flow), auth_provider, ema…
- [Retry mass-action items](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/mass_action_items/retry-mass-action-items.md): Re-enter FAILED items of a mass action AT their current_step: completed steps are never re-executed, so no duplicate creates and no double sends; their step_log entries and minted objects survive untouc…
- [Search mass-action items](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/mass_action_items/search-mass-action-items.md): Per-target drill-down of a mass action: one row per target with current_step, the object cursor (object_type / object_sid, on a generative run what the row created) and step_log[], one entry per plan st…
- [Create mass-action](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/mass_actions/create-mass-action.md): Commit a previewed plan into a running bulk dispatch. Requires the commit_token from preview_mass_action over EXACTLY these inputs: the server re-derives the HMAC, so an edited plan, a changed scope or…
- [Mass-action metrics](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/mass_actions/mass-action-metrics.md): Where a run is right now, in one round-trip, without paging items. Typical call: filter {sid:{eq}}. Returns items_by_status (the outcome split), items_by_current_step, items_by_wait_reason, in_flight (0…
- [Preview mass-action plan](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/mass_actions/preview-mass-action-plan.md): Validate a whole bulk plan without running anything and mint the consent token create_mass_action consumes. ALWAYS the first call of a bulk dispatch.
- [Search mass-actions](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/mass_actions/search-mass-actions.md): List the team's bulk runs with filter, sort and cursor pagination. Filter by status (active / paused), paused_reason, target_entity, canary_satisfied_at (is_null:true = the canary gate is still closed),…
- [Get mass-action](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/mass_actions/get-mass-action.md): Fetch one bulk run by sid: the plan that runs, status / paused_reason / hold_till, the canary gate and settled_at. include=metrics adds the item breakdown, which is where outcome lives.
- [Stop and delete mass-action](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/mass_actions/stop-and-delete-mass-action.md): STOP a bulk run. This is the cancel path and it works at any status: pending and queued items are swept to cancelled, running items finish their current step and stop at the boundary, an auto-scrape fee…
- [Append mass-action items](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/mass_actions/append-mass-action-items.md): Feed more targets into a run that is already going, without a second preview or consent token: the plan they execute is the one already approved, and appended items join the pacing chain BEHIND the tail…
- [Pause mass-action](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/mass_actions/pause-mass-action.md): Freeze dispatch: status becomes paused with paused_reason='manual'. Queued jobs roll back at pre-flight and in-flight items finish their current step, then stop at the boundary; vendor calls already on…
- [Release mass-action canary](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/mass_actions/release-mass-action-canary.md): Open the canary gate by hand: stamps canary_satisfied_at and releases every remaining item, the same sweep the canary would have triggered by succeeding. Use it when the first item failed for a reason y…
- [Resume mass-action](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/mass_actions/resume-mass-action.md): Unfreeze dispatch: status becomes active, paused_reason and hold_till are cleared, and pending items are re-planned onto a fresh jitter chain from now. Items that deferred mid-cascade restart at their c…
- [Webhook logs metrics](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/webhook_logs/webhook-logs-metrics.md): Period-bound aggregates over webhook deliveries: success_rate, failure_rate, p50/p95/p99 latency, total_retries, last_success_at / last_failure_at. Requires period {from,to} (≤ 90 days). Optional filter…
- [Search webhook logs](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/webhook_logs/search-webhook-logs.md): List webhook delivery rows for the caller's team with filter, sort, include and group-counts. Deliveries from every producer service (LinkedIn, email, …) land in this one log; filter per webhook, per ac…
- [Cancel webhook delivery](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/webhook_logs/cancel-webhook-delivery.md): Cancel a webhook delivery (status → cancelled); no further retries. Allowed from pending / retrying / in_progress; terminal rows → 422 cannot_cancel_terminal. Cancelling an in_progress row may still fli…
- [Retry webhook delivery](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/webhook_logs/retry-webhook-delivery.md): Manually re-arm a webhook delivery row: flips status to pending, sets scheduled_at=now(), increments retry_count. error_message is preserved (cleared only on the next successful terminal outcome). Allow…
- [Create webhook](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/webhooks/create-webhook.md): Create a webhook subscription endpoint. The server generates a 32-char hex secret and returns it ONCE in this response (masked on every subsequent read). Store it client-side for HMAC verification. targ…
- [Search webhooks](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/webhooks/search-webhooks.md): List webhook subscriptions owned by the caller's team with filter, sort and cursor pagination. Filter by status, subscribed event types (events.contains / contains_any), account narrowing or name; inclu…
- [Get webhook](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/webhooks/get-webhook.md): Fetch a single webhook by sid. Use include=latest_webhook_logs for the recent delivery view. secret is masked (null) on reads.
- [Delete webhook](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/webhooks/delete-webhook.md): Soft-delete a webhook (deleted_at set; webhook stops matching new events). Existing webhook_logs remain queryable but un-retryable; pending / retrying deliveries are cancelled. Destructive and one-way (…
- [Update webhook](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/webhooks/update-webhook.md): Patch a webhook. Editable fields: name, target_url, events, filters, status. status:'on' on a failed webhook resets the consecutive-failure counter and resumes deliveries; status:'failed' cannot be set…
- [Test webhook](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/webhooks/test-webhook.md): Synchronously POST a synthetic payload to the webhook target_url and return the receiver response (HTTP status, duration, error kind). Verifies endpoint health / signature handling without waiting for a…
- [MCP server](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/mcp/overview.md): The same platform, exposed as Model Context Protocol tools an AI agent can call.
- [Connect a client](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/mcp/connect.md): Add the gtm-api MCP server to Claude, Cursor, VS Code, ChatGPT or any MCP-compatible runtime.
- [Agent-native signup and billing](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/mcp/agent-signup.md): How an AI agent registers its operator, connects itself, and handles the moment the workspace needs a paid plan.
- [Use these docs from your AI tools](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/mcp/use-docs-with-ai.md): The documentation has its own MCP endpoint, plus llms.txt and per-page Markdown.
- [Changelog](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/changelog.md): What's new in the GTM API platform and this documentation.

## OpenAPI Specs

- [openapi](https://getsalesio-admin-mcp-wording-for-good-7879419.mintlify.site/api-reference/orchestration/openapi.yaml)