---
title: "POST /api/v1/config/external-connections"
method: POST
path: "/api/v1/config/external-connections"
tags: ["ExternalConnection"]
---

# POST /api/v1/config/external-connections

`POST /api/v1/config/external-connections`

## Request body

- Configv1CreateExternalConnectionRequest
  - `dry_run` boolean — If `true`, validates the specified configuration without creating the ExternalConnection. If the specified configuration is valid, the endpoint returns a partial response without the ExternalConnection. If the specified configuration is invalid, the endpoint returns an error.
  - `external_connection` Configv1ExternalConnection
    - `cloudflare` ExternalConnectionCloudflareConfig
      - `api_token` string — Cloudflare API Token. Accepts User API Tokens (cfut_ prefix) and Account API Tokens (cfat_ prefix).
    - `created_at` string, date-time — Timestamp of when the ExternalConnection was created. Cannot be set by clients.
    - `mongodb_atlas` ExternalConnectionMongoDbAtlasConfig
      - `client_id` string — Service Account client ID.
      - `client_secret` string — Service Account client secret.
    - `name` string, required — The name of the ExternalConnection. You can modify this value after the ExternalConnection is created.
    - `ops_genie` Configv1ExternalConnectionOpsGenieConfig
      - `api_key` string
      - `api_url` string
      - `http_config` Configv1ExternalConnectionHTTPConfig
        - `basic_auth` Configv1ExternalConnectionHTTPConfigBasicAuth
          - `password` string
          - `username` string
        - `bearer_token` string
        - `tls_config` Configv1ExternalConnectionHTTPConfigTLSConfig
          - `insecure_skip_verify` boolean
    - `pagerduty` Configv1ExternalConnectionPagerdutyConfig
      - `events` PagerdutyConfigPagerdutyEventsConfig
        - `api_key` string — The PagerDuty integration key used to authenticate with the Events API. PagerDuty calls this the "routing key" in Events v2 and the "service key" in Events v1.
        - `version` 'PAGERDUTY_EVENTS_VERSION_V1' | 'PAGERDUTY_EVENTS_VERSION_V2' — PagerdutyEventsVersion selects the PagerDuty Events API version. The version determines which PagerDuty Events API payload format is used when delivering alerts through this external connection. - PAGERDUTY_EVENTS_VERSION_V1: V1 is the legacy PagerDuty Events API version. - PAGERDUTY_EVENTS_VERSION_V2: V2 is the default and recommended version.
      - `rest` PagerdutyConfigPagerdutyRESTConfig
        - `api_key` string — The PagerDuty REST API token used to authenticate note polling.
    - `sendgrid` ExternalConnectionSendgridConfig
      - `api_key` string — SendGrid API key (Bearer token).
    - `slack` Configv1ExternalConnectionSlackConfig
      - `api_url` string
      - `token` string
    - `slug` string — The unique identifier of the ExternalConnection. If a `slug` isn't provided, one is generated based on the `name` field. You can't modify this field after the ExternalConnection is created.
    - `updated_at` string, date-time — Timestamp of when the ExternalConnection was last updated. Cannot be set by clients.
    - `victor_ops` Configv1ExternalConnectionVictorOpsConfig
      - `api_key` string
      - `api_url` string
    - `webhook` Configv1ExternalConnectionWebhookConfig
      - `http_config` Configv1ExternalConnectionHTTPConfig
        - `basic_auth` Configv1ExternalConnectionHTTPConfigBasicAuth
          - `password` string
          - `username` string
        - `bearer_token` string
        - `tls_config` Configv1ExternalConnectionHTTPConfigTLSConfig
          - `insecure_skip_verify` boolean
      - `url` string

## Response `200`

A successful response containing the created ExternalConnection.

- Configv1CreateExternalConnectionResponse
  - `external_connection` Configv1ExternalConnection
    - `cloudflare` ExternalConnectionCloudflareConfig
      - `api_token` string — Cloudflare API Token. Accepts User API Tokens (cfut_ prefix) and Account API Tokens (cfat_ prefix).
    - `created_at` string, date-time — Timestamp of when the ExternalConnection was created. Cannot be set by clients.
    - `mongodb_atlas` ExternalConnectionMongoDbAtlasConfig
      - `client_id` string — Service Account client ID.
      - `client_secret` string — Service Account client secret.
    - `name` string, required — The name of the ExternalConnection. You can modify this value after the ExternalConnection is created.
    - `ops_genie` Configv1ExternalConnectionOpsGenieConfig
      - `api_key` string
      - `api_url` string
      - `http_config` Configv1ExternalConnectionHTTPConfig
        - `basic_auth` Configv1ExternalConnectionHTTPConfigBasicAuth
          - `password` string
          - `username` string
        - `bearer_token` string
        - `tls_config` Configv1ExternalConnectionHTTPConfigTLSConfig
          - `insecure_skip_verify` boolean
    - `pagerduty` Configv1ExternalConnectionPagerdutyConfig
      - `events` PagerdutyConfigPagerdutyEventsConfig
        - `api_key` string — The PagerDuty integration key used to authenticate with the Events API. PagerDuty calls this the "routing key" in Events v2 and the "service key" in Events v1.
        - `version` 'PAGERDUTY_EVENTS_VERSION_V1' | 'PAGERDUTY_EVENTS_VERSION_V2' — PagerdutyEventsVersion selects the PagerDuty Events API version. The version determines which PagerDuty Events API payload format is used when delivering alerts through this external connection. - PAGERDUTY_EVENTS_VERSION_V1: V1 is the legacy PagerDuty Events API version. - PAGERDUTY_EVENTS_VERSION_V2: V2 is the default and recommended version.
      - `rest` PagerdutyConfigPagerdutyRESTConfig
        - `api_key` string — The PagerDuty REST API token used to authenticate note polling.
    - `sendgrid` ExternalConnectionSendgridConfig
      - `api_key` string — SendGrid API key (Bearer token).
    - `slack` Configv1ExternalConnectionSlackConfig
      - `api_url` string
      - `token` string
    - `slug` string — The unique identifier of the ExternalConnection. If a `slug` isn't provided, one is generated based on the `name` field. You can't modify this field after the ExternalConnection is created.
    - `updated_at` string, date-time — Timestamp of when the ExternalConnection was last updated. Cannot be set by clients.
    - `victor_ops` Configv1ExternalConnectionVictorOpsConfig
      - `api_key` string
      - `api_url` string
    - `webhook` Configv1ExternalConnectionWebhookConfig
      - `http_config` Configv1ExternalConnectionHTTPConfig
        - `basic_auth` Configv1ExternalConnectionHTTPConfigBasicAuth
          - `password` string
          - `username` string
        - `bearer_token` string
        - `tls_config` Configv1ExternalConnectionHTTPConfigTLSConfig
          - `insecure_skip_verify` boolean
      - `url` string

## Other responses

- `400` — Cannot create the ExternalConnection because the request is invalid.
- `409` — Cannot create the ExternalConnection because there is a conflict with an existing ExternalConnection.
- `500` — An unexpected error response.
- `default` — An undefined error response.

---

[API](https://skmtc.dev/chronosphere/apis/data-v1-api.md) · [All operations](https://skmtc.dev/chronosphere/apis/data-v1-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chronosphere/data-v1-api/revisions/ee91fd539ced/schema)