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

# Business-system connection guides

> See what each ApexGenius connection requires, where it is scoped, and which vendor documentation remains authoritative.

ApexGenius separates AI clients from business-system connections.

* **AI clients** such as Claude, ChatGPT, Cursor, and VS Code connect to the ApexGenius MCP endpoint.
* **Business systems** such as Salesforce, n8n, Jira, Confluence, and HQ Rental connect inside the ApexGenius gateway.

## Connection scope

For Salesforce, an ApexGenius project identifies one authorized Salesforce org and its metadata workspace.

n8n, Confluence, and the private-preview providers use connections owned by the signed-in ApexGenius user. Jira is also user-owned while its Beta route is completed. The current Jira and Confluence operation schemas still require an ApexGenius `project_id` so the gateway can apply the account's project authorization and activation checks. That gate does not turn a Jira project, Confluence space, n8n workflow, or HQ Rental tenant into an ApexGenius project.

## Guides

| Provider              | Customer setup                                                                  | ApexGenius scope                                                                                                           | Our guide                                                     | Vendor source                                                                                                                        |
| --------------------- | ------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| Salesforce            | Salesforce OAuth                                                                | Salesforce project and org                                                                                                 | [Connect Salesforce](/getting-started/connect-salesforce)     | [Salesforce OAuth](https://help.salesforce.com/s/articleView?id=sf.configure_external_client_app_oauth_settings.htm\&language=en_US) |
| n8n                   | Instance URL and API key                                                        | Signed-in user and n8n instance                                                                                            | [Connect n8n](/integrations/n8n)                              | [n8n API auth](https://docs.n8n.io/connect/n8n-api/authentication/)                                                                  |
| Jira (Beta)           | Atlassian OAuth                                                                 | Signed-in user connection; each operation also carries an authorized ApexGenius `project_id` during the current transition | [Connect Jira](/integrations/jira)                            | [Jira 3LO](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/)                                                    |
| Confluence            | Atlassian OAuth                                                                 | Signed-in user connection; each operation also carries an authorized ApexGenius `project_id` for the gateway access check  | [Connect Confluence](/integrations/confluence)                | [Confluence 3LO](https://developer.atlassian.com/cloud/confluence/oauth-2-3lo-apps/)                                                 |
| HQ Rental             | Eligible plan, enabled Custom Integration, region, tenant token, and user token | Signed-in user and HQ tenant                                                                                               | [Connect HQ Rental](/integrations/hq-rental)                  | [HQ authorization](https://api-docs.hqrentalsoftware.com/doc-624611.md)                                                              |
| Google Ads            | Google OAuth                                                                    | Signed-in user and enabled customer accounts                                                                               | [Connect Google Ads](/integrations/google-ads)                | [Google Ads onboarding](https://developers.google.com/google-ads/api/docs/get-started/onboarding)                                    |
| Google Search Console | Google OAuth                                                                    | Signed-in user and enabled properties                                                                                      | [Connect Search Console](/integrations/google-search-console) | [Search Console auth](https://developers.google.com/webmaster-tools/v1/how-tos/authorizing)                                          |
| Google Analytics      | Read-only Google OAuth                                                          | Signed-in user and enabled GA4 properties                                                                                  | [Connect Google Analytics](/integrations/google-analytics)    | [Analytics Data API](https://developers.google.com/analytics/devguides/reporting/data/v1)                                            |
| Gmail                 | Google OAuth and official hosted MCP                                            | Signed-in user and connected Google account                                                                                | [Connect Google Workspace](/integrations/google-workspace)    | [Workspace MCP setup](https://developers.google.com/workspace/guides/configure-mcp-servers)                                          |
| Google Drive          | Google OAuth and official hosted MCP                                            | Signed-in user and connected Google account                                                                                | [Connect Google Workspace](/integrations/google-workspace)    | [Workspace MCP setup](https://developers.google.com/workspace/guides/configure-mcp-servers)                                          |
| Google Docs           | Google OAuth and official hosted MCP                                            | Signed-in user and connected Google account                                                                                | [Connect Google Workspace](/integrations/google-workspace)    | [Workspace MCP setup](https://developers.google.com/workspace/guides/configure-mcp-servers)                                          |
| Google Sheets         | Google OAuth and official hosted MCP                                            | Signed-in user and connected Google account                                                                                | [Connect Google Workspace](/integrations/google-workspace)    | [Workspace MCP setup](https://developers.google.com/workspace/guides/configure-mcp-servers)                                          |
| Google Slides         | Google OAuth and official hosted MCP                                            | Signed-in user and connected Google account                                                                                | [Connect Google Workspace](/integrations/google-workspace)    | [Workspace MCP setup](https://developers.google.com/workspace/guides/configure-mcp-servers)                                          |
| Google Calendar       | Google OAuth and official hosted MCP                                            | Signed-in user and connected Google account                                                                                | [Connect Google Workspace](/integrations/google-workspace)    | [Workspace MCP setup](https://developers.google.com/workspace/guides/configure-mcp-servers)                                          |
| Google Chat           | Google OAuth, Chat app, and official hosted MCP                                 | Signed-in user and connected Google account                                                                                | [Connect Google Workspace](/integrations/google-workspace)    | [Workspace MCP setup](https://developers.google.com/workspace/guides/configure-mcp-servers)                                          |
| Google People         | Google OAuth and official hosted MCP                                            | Signed-in user and connected Google account                                                                                | [Connect Google Workspace](/integrations/google-workspace)    | [Workspace MCP setup](https://developers.google.com/workspace/guides/configure-mcp-servers)                                          |
| Google Tasks          | Google OAuth and official Tasks API                                             | Signed-in user and enabled task lists                                                                                      | [Connect Google Workspace](/integrations/google-workspace)    | [Tasks API](https://developers.google.com/workspace/tasks)                                                                           |
| Google Forms          | Google OAuth and official Forms API                                             | Signed-in user and enabled forms                                                                                           | [Connect Google Workspace](/integrations/google-workspace)    | [Forms API](https://developers.google.com/workspace/forms/api/guides)                                                                |
| Google Meet           | Google OAuth and official Meet API                                              | Signed-in user and connected Google account                                                                                | [Connect Google Workspace](/integrations/google-workspace)    | [Meet REST API](https://developers.google.com/workspace/meet/api/guides/overview)                                                    |
| Upwork                | Official Upwork MCP OAuth                                                       | Signed-in user and connected Upwork account                                                                                | [Connect Upwork](/integrations/upwork)                        | [Upwork MCP](https://www.upwork.com/ai/mcp)                                                                                          |
| Apollo                | Official Apollo MCP OAuth                                                       | Signed-in user and connected Apollo workspace                                                                              | [Connect Apollo](/integrations/apollo)                        | [Apollo MCP](https://docs.apollo.io/docs/apollo-mcp)                                                                                 |
| Notion                | Official Notion MCP OAuth                                                       | Signed-in user and connected Notion workspace                                                                              | [Connect Notion](/integrations/notion)                        | [Notion MCP](https://developers.notion.com/guides/mcp/overview)                                                                      |
| Blotato               | Hosted MCP OAuth pending contract smoke test                                    | Signed-in user and connected Blotato account                                                                               | [Connect Blotato](/integrations/blotato)                      | [Blotato MCP tools](https://help.blotato.com/api/mcp/tools)                                                                          |
| HighLevel             | Official portable MCP OAuth                                                     | Signed-in user and one connected HighLevel location                                                                        | [Connect HighLevel](/integrations/gohighlevel)                | [HighLevel MCP](https://marketplace.gohighlevel.com/docs/other/mcp/)                                                                 |
| Facebook              | Meta OAuth and approved Page permissions                                        | Signed-in user and enabled Facebook Pages                                                                                  | This guide                                                    | [Meta Pages API](https://developers.facebook.com/docs/pages-api/)                                                                    |
| Instagram             | Meta OAuth, linked Page, and professional account                               | Signed-in user and enabled Instagram professional accounts                                                                 | This guide                                                    | [Instagram API](https://developers.facebook.com/docs/instagram-platform/)                                                            |
| Threads               | Threads OAuth and approved publishing permissions                               | Signed-in user and connected Threads profile                                                                               | This guide                                                    | [Threads API](https://developers.facebook.com/docs/threads/)                                                                         |
| YouTube               | Google OAuth and YouTube Data API                                               | Signed-in user and enabled channel                                                                                         | This guide                                                    | [YouTube Data API](https://developers.google.com/youtube/v3)                                                                         |
| TikTok                | Login Kit and Content Posting API                                               | Signed-in user and connected creator account                                                                               | This guide                                                    | [Content Posting API](https://developers.tiktok.com/docs/en/content-posting-api-get-started)                                         |
| Pinterest             | Pinterest OAuth and API access                                                  | Signed-in user and enabled boards                                                                                          | This guide                                                    | [Pinterest API v5](https://developers.pinterest.com/docs/api/v5/)                                                                    |
| X                     | OAuth 2.0 PKCE, API access, and provider credits                                | Signed-in user and connected X account                                                                                     | This guide                                                    | [X API](https://docs.x.com/x-api/introduction)                                                                                       |
| LinkedIn              | OIDC and Share on LinkedIn OAuth                                                | Signed-in user, member profile, and approved company Pages                                                                 | This guide                                                    | [LinkedIn Marketing APIs](https://learn.microsoft.com/en-us/linkedin/marketing/)                                                     |
| Bluesky               | Revocable app password                                                          | Signed-in user and connected Bluesky account                                                                               | This guide                                                    | [AT Protocol](https://docs.bsky.app/)                                                                                                |

Each ApexGenius guide links to the matching vendor documentation. Vendor documentation is authoritative for provider permissions, API behavior, plan requirements, and rate limits. ApexGenius documentation is authoritative for the gateway-specific setup and current product boundary.

## Social publishing controls

The social connectors use official provider APIs. Outward publishing, upload, update, and deletion tools are risk-labeled so compatible AI clients can request confirmation before sending them. Supported provider writes are recorded in the gateway write audit without storing provider credentials in the audit payload.

For providers with selectable resources, the connection owner must also enable the specific Facebook Page, Instagram account, LinkedIn author, YouTube channel, or Pinterest board. A valid OAuth token does not override that resource allowlist.

Media URLs supplied to Bluesky, X, LinkedIn, or YouTube are fetched through the gateway's public-URL guard. Private IP ranges, unsafe DNS results, redirects, oversized payloads, and unexpected media types are rejected before an upload reaches the provider.

## Provider review gates

The connector code can be live before a third-party developer app receives every production permission. The connection screen reports missing developer-app configuration instead of presenting a false connected state.

| Provider  | Core private-preview capability                                                                                         | External production gate                                                                               |
| --------- | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| Facebook  | Page discovery, posts, photos, scheduling, insights, and approved Graph API calls                                       | Meta app review and business or access verification for advanced permissions                           |
| Instagram | Professional-account discovery, image/video/Reel/Story containers, publishing, status, insights, and approved API calls | Meta review for Instagram permissions; the account must be eligible and linked correctly               |
| Threads   | Text, image, video, carousel, reply publishing, insights, deletion, and approved API calls                              | Threads app configuration and review for requested permissions                                         |
| YouTube   | Channel discovery, resumable video uploads, metadata, listing, updates, and approved Data API calls                     | Google OAuth verification and any required YouTube API compliance audit                                |
| TikTok    | Creator preflight, video/photo direct posts or draft inbox, publish status, and approved API calls                      | TikTok scope approval and Content Posting API audit; unaudited direct posts remain private             |
| Pinterest | Board discovery, Pin creation/update/deletion, and approved API calls                                                   | Pinterest Standard access review after trial access                                                    |
| X         | Profile confirmation, text/media posts, threads, replies, deletion, and approved API v2 calls                           | An enabled and funded X API project; AI reply automation remains off without written provider approval |
| LinkedIn  | Member text/image publishing and approved versioned API calls                                                           | Company Page authors require Community Management API approval and appropriate Page roles              |
| Bluesky   | Text, reply, and guarded image posts                                                                                    | No developer app review; the user creates a revocable app password                                     |

<Info>
  **Private preview does not guarantee availability.**

  An allowlisted ApexGenius user can use a connector only after its production developer app is configured, the provider grants the required scopes, and the connection passes a live verification. ApexGenius keeps operations unavailable while those gates remain incomplete.
</Info>

<Warning>
  **Availability differs by provider.**

  Salesforce, n8n, and Confluence are available. Jira remains Beta. HQ Rental, Google Ads, Search Console, Analytics, Google Workspace, Upwork, Apollo, Notion, Blotato, HighLevel, and the native social connectors are private previews. Google Workspace MCP also requires Developer Preview enrollment. Notion, Blotato, and HighLevel remain inactive until compliance review and live OAuth smoke tests are complete. Read the status and developer-app note before relying on a connection in production work.
</Warning>
