> ## Documentation Index > Fetch the complete documentation index at: https://docs.superlog.sh/llms.txt > Use this file to discover all available pages before exploring further. # Get an integration consent link > Starts connecting one integration to the workspace. For OAuth providers, returns a consent link that is personal to the signed-in person and workspace and expires after ten minutes, or status `connected` when an existing connection is recovered. A new connection completes after the person approves access in a browser signed in to the same Superlog account and workspace. For integrations that need credentials or extra setup, returns a link to secure setup in Superlog. ## OpenAPI ````yaml /api-reference/openapi.json post /integrations/connect openapi: 3.1.0 info: description: >- Manage a Superlog workspace's automations, runs, tag mode, model access, and secrets, read its telemetry, build dashboards and alerts over it, run synthetic checks, and export them to Terraform. Every request acts as the member who created the API key. title: Superlog management API version: 1.0.0 servers: - url: https://superlog.sh/api/v1 security: - bearerAuth: [] tags: - description: Connected integrations and the IDs automations and tag mode use. name: Integrations - description: The workspace and its members. name: Workspace - description: Keys that authenticate the management API and MCP server. name: API keys - description: Create and change automations. name: Automations - description: Start, follow, and cancel automation runs. name: Runs - description: What Superlog can use and change when someone mentions it in Slack. name: Tag mode - description: Model API keys, subscriptions, and available models. name: Models - description: Credentials agents can use without seeing them. name: Secrets - description: Read the workspace's logs, traces, and metrics. name: Telemetry - description: >- Exceptions in the workspace's telemetry, grouped into issues by fingerprint. name: Errors - description: Create and change dashboards over the workspace's telemetry. name: Dashboards - description: Threshold alerts on the workspace's telemetry that post to Slack. name: Alerts - description: HTTP checks that request a URL on a schedule and post failures to Slack. name: Synthetics - description: Configuration for the superloglabs/superlog Terraform provider. name: Terraform paths: /integrations/connect: post: tags: - Integrations summary: Get an integration consent link description: >- Starts connecting one integration to the workspace. For OAuth providers, returns a consent link that is personal to the signed-in person and workspace and expires after ten minutes, or status `connected` when an existing connection is recovered. A new connection completes after the person approves access in a browser signed in to the same Superlog account and workspace. For integrations that need credentials or extra setup, returns a link to secure setup in Superlog. operationId: start_integration_connection requestBody: content: application/json: schema: type: object properties: provider: type: string enum: - aws - gcp - github - slack - sentry - datadog - dash0 - posthog - grafana - cloudflare - railway - axiom - upstash - langfuse - supabase - vercel - custom_mcp - clickstack - linear - discord - devrev - signoz - honeycomb - betterstack description: Provider selected for the user's goal. required: - provider required: true responses: '200': content: application/json: schema: type: object properties: provider: type: string enum: - aws - gcp - github - slack - sentry - datadog - dash0 - posthog - grafana - cloudflare - railway - axiom - upstash - langfuse - supabase - vercel - custom_mcp - clickstack - linear - discord - devrev - signoz - honeycomb - betterstack connectionType: type: string enum: - oauth - secure_setup status: type: string enum: - awaiting_consent - setup_required - connected url: type: string format: uri handoffUrl: type: string format: uri expiresAt: anyOf: - type: string format: date-time - type: 'null' instructions: type: string required: - provider - connectionType - status - url - expiresAt - instructions additionalProperties: false description: OK '400': content: application/json: schema: $ref: '#/components/schemas/Error' description: The request is invalid. `issues` lists each invalid field. '401': content: application/json: schema: $ref: '#/components/schemas/Error' description: The API key is missing, revoked, or its creator left the workspace. '409': content: application/json: schema: $ref: '#/components/schemas/Error' description: >- The request conflicts with the current state, such as a name already in use. security: - bearerAuth: [] components: schemas: Error: type: object properties: code: description: A stable machine-readable error code, when there is one. type: string error: type: string description: What went wrong. issues: description: Validation problems, one per invalid field. type: array items: type: object properties: message: type: string path: type: array items: anyOf: - type: string - type: number required: - message - path additionalProperties: false required: - error additionalProperties: false securitySchemes: bearerAuth: description: A workspace API key, created in Superlog under Settings → API keys. scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.