---
title: "POST /integrations/connections/"
method: POST
path: "/integrations/connections/"
tags: ["integrations"]
---

# POST /integrations/connections/

`POST /integrations/connections/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/integrations/connections/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

API endpoints for managing integration connections.

## Request body

- IntegrationConnectionCreate
  - `platform` 'langfuse' | 'datadog' | 'posthog' | 'pagerduty' | 'mixpanel' | 'cloud_storage' | 'message_queue' | 'linear' | 'slack', required
  - `host_url` string, uri
  - `public_key` string
  - `secret_key` string
  - `ca_certificate` string
  - `credentials` object
  - `project_id` string, uuid, nullable: Existing FutureAGI project ID. If null, a new project is created.
  - `new_project_name` string: Name for the new project (used when project_id is null).
  - `backfill_option` 'all' | 'from_date' | 'new_only'
  - `backfill_from_date` string, date-time, nullable
  - `backfill_to_date` string, date-time, nullable
  - `sync_interval_seconds` integer
  - `display_name` string
  - `external_project_name` string
  - `export_config` object

## Response `201`

Created

- IntegrationConnectionDetailResponse
  - `status` boolean
  - `result` IntegrationConnectionDetail, required
    - `id` string, uuid
    - `platform` 'langfuse' | 'datadog' | 'posthog' | 'pagerduty' | 'mixpanel' | 'cloud_storage' | 'message_queue' | 'linear' | 'slack', required
    - `display_name` string, required
    - `host_url` string, uri, required
    - `status` 'active' | 'paused' | 'error' | 'syncing' | 'backfilling'
    - `status_message` string, nullable
    - `external_project_name` string, required
    - `project` string, uuid, nullable
    - `project_name` string
    - `public_key_display` string
    - `secret_key_display` string
    - `last_synced_at` string, date-time, nullable
    - `sync_cursor` object
    - `sync_interval_seconds` integer
    - `last_error_notified_at` string, date-time, nullable
    - `backfill_from` string, date-time, nullable
    - `backfill_completed` boolean
    - `backfill_progress` object
    - `total_traces_synced` integer
    - `total_spans_synced` integer
    - `total_scores_synced` integer
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `created_by` string, uuid, nullable

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)