---
title: "Integration Configure Route"
method: POST
path: "/api/connections/configure"
tags: ["connections"]
---

# Integration Configure Route

`POST /api/connections/configure`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/connections/configure`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

## Request body

- ApolloIntegrationConfiguration
  - `api_key` string, required: Private Apollo API key. The backend never returns this value.
  - `provider` 'apollo', required: Apollo credential configuration.

## Response `200`

Successful Response

- IntegrationConfigurationResponse
  - `connected` true, required: The credential was stored and accepted by Apollo.
  - `connection_id` string, required: Durable workspace connection identifier.
  - `metadata` ApolloIntegrationMetadata, required
    - `auth_mode` 'api_key', required: The configured connection uses workspace API-key authority.
  - `provider` 'apollo', required: Configured provider identifier.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)