---
title: "Get integration configurations"
method: GET
path: "/integrations/config"
tags: ["Integrations"]
---

# Get integration configurations

`GET /integrations/config`

Returns the base capabilities and current sync configuration for all connected providers.

## Response `200`

OK

- IntegrationConfigResponse
  - `integrations` IntegrationConfigEntry[]
    - `base_config` TypesSyncConfig
      - `aws_marketplace` TypesAWSMarketplaceSyncConfig
        - `region` string
      - `customer` TypesEntitySyncConfig
        - `inbound` boolean — Inbound from external provider to FlexPrice
        - `outbound` boolean — Outbound from FlexPrice to external provider
      - `deal` TypesEntitySyncConfig
        - `inbound` boolean — Inbound from external provider to FlexPrice
        - `outbound` boolean — Outbound from FlexPrice to external provider
      - `invoice` TypesEntitySyncConfig
        - `inbound` boolean — Inbound from external provider to FlexPrice
        - `outbound` boolean — Outbound from FlexPrice to external provider
      - `invoice_sync_settings` TypesInvoiceSyncSettings
        - `metadata_custom_fields` TypesMetadataCustomField[] — MetadataCustomFields copies metadata values onto Zoho invoice custom fields verbatim.
          - `field` string
          - `metadata_key` string
          - `source` 'customer' | 'invoice'
        - `normalize_fixed_to` 'MONTHLY' | 'ANNUAL' | 'WEEKLY' | 'DAILY' | 'QUARTERLY' | 'HALF_YEARLY' | 'ONETIME'
        - `service_period_custom_fields` TypesServicePeriodCustomFields
          - `end_field_id` string
          - `start_field_id` string
        - `submit_for_approval` boolean — SubmitForApproval submits the synced invoice into the merchant's Zoho Books approval flow before recording payment. Zoho rejects payments on draft invoices, and merchants configure a Zoho auto-approval rule for FlexPrice-sent invoices, so we submit, wait for that rule to fire, then pay.
      - `payment` TypesEntitySyncConfig
        - `inbound` boolean — Inbound from external provider to FlexPrice
        - `outbound` boolean — Outbound from FlexPrice to external provider
      - `plan` TypesEntitySyncConfig
        - `inbound` boolean — Inbound from external provider to FlexPrice
        - `outbound` boolean — Outbound from FlexPrice to external provider
      - `price` TypesEntitySyncConfig
        - `inbound` boolean — Inbound from external provider to FlexPrice
        - `outbound` boolean — Outbound from FlexPrice to external provider
      - `quote` TypesEntitySyncConfig
        - `inbound` boolean — Inbound from external provider to FlexPrice
        - `outbound` boolean — Outbound from FlexPrice to external provider
      - `s3` TypesS3ExportConfig
        - `bucket` string — S3 bucket name
        - `compression` 'none' | 'gzip'
        - `encryption` 'AES256' | 'aws:kms' | 'aws:kms:dsse'
        - `is_flexprice_managed` boolean — If true, use Flexprice-managed S3 credentials instead of user-provided
        - `key_prefix` string — Optional prefix for S3 keys (e.g., "flexprice-exports/")
        - `region` string — AWS region (e.g., "us-west-2")
      - `subscription` TypesEntitySyncConfig
        - `inbound` boolean — Inbound from external provider to FlexPrice
        - `outbound` boolean — Outbound from FlexPrice to external provider
    - `current_config` TypesSyncConfig
      - `aws_marketplace` TypesAWSMarketplaceSyncConfig
        - `region` string
      - `customer` TypesEntitySyncConfig
        - `inbound` boolean — Inbound from external provider to FlexPrice
        - `outbound` boolean — Outbound from FlexPrice to external provider
      - `deal` TypesEntitySyncConfig
        - `inbound` boolean — Inbound from external provider to FlexPrice
        - `outbound` boolean — Outbound from FlexPrice to external provider
      - `invoice` TypesEntitySyncConfig
        - `inbound` boolean — Inbound from external provider to FlexPrice
        - `outbound` boolean — Outbound from FlexPrice to external provider
      - `invoice_sync_settings` TypesInvoiceSyncSettings
        - `metadata_custom_fields` TypesMetadataCustomField[] — MetadataCustomFields copies metadata values onto Zoho invoice custom fields verbatim.
          - `field` string
          - `metadata_key` string
          - `source` 'customer' | 'invoice'
        - `normalize_fixed_to` 'MONTHLY' | 'ANNUAL' | 'WEEKLY' | 'DAILY' | 'QUARTERLY' | 'HALF_YEARLY' | 'ONETIME'
        - `service_period_custom_fields` TypesServicePeriodCustomFields
          - `end_field_id` string
          - `start_field_id` string
        - `submit_for_approval` boolean — SubmitForApproval submits the synced invoice into the merchant's Zoho Books approval flow before recording payment. Zoho rejects payments on draft invoices, and merchants configure a Zoho auto-approval rule for FlexPrice-sent invoices, so we submit, wait for that rule to fire, then pay.
      - `payment` TypesEntitySyncConfig
        - `inbound` boolean — Inbound from external provider to FlexPrice
        - `outbound` boolean — Outbound from FlexPrice to external provider
      - `plan` TypesEntitySyncConfig
        - `inbound` boolean — Inbound from external provider to FlexPrice
        - `outbound` boolean — Outbound from FlexPrice to external provider
      - `price` TypesEntitySyncConfig
        - `inbound` boolean — Inbound from external provider to FlexPrice
        - `outbound` boolean — Outbound from FlexPrice to external provider
      - `quote` TypesEntitySyncConfig
        - `inbound` boolean — Inbound from external provider to FlexPrice
        - `outbound` boolean — Outbound from FlexPrice to external provider
      - `s3` TypesS3ExportConfig
        - `bucket` string — S3 bucket name
        - `compression` 'none' | 'gzip'
        - `encryption` 'AES256' | 'aws:kms' | 'aws:kms:dsse'
        - `is_flexprice_managed` boolean — If true, use Flexprice-managed S3 credentials instead of user-provided
        - `key_prefix` string — Optional prefix for S3 keys (e.g., "flexprice-exports/")
        - `region` string — AWS region (e.g., "us-west-2")
      - `subscription` TypesEntitySyncConfig
        - `inbound` boolean — Inbound from external provider to FlexPrice
        - `outbound` boolean — Outbound from FlexPrice to external provider
    - `provider` 'flexprice' | 'stripe' | 's3' | 'gcs' | 'hubspot' | 'razorpay' | 'chargebee' | 'quickbooks' | 'zoho_books' | 'nomod' | 'moyasar' | 'paddle' | 'whop' | 'tabs' | 'aws_marketplace' | 'gcp_marketplace' | 'azure_marketplace'

## Other responses

- `500` — Internal Server Error

## Changes

- **2026-09-01** `e1d4e27b5677` — 1 warning, 2 info
  - added the new `gcs` enum value to the `integrations/items/provider` response property for the response status `200`
  - added the optional property `integrations/items/base_config/invoice_sync_settings/submit_for_approval` to the response with the `200` status
  - added the optional property `integrations/items/current_config/invoice_sync_settings/submit_for_approval` to the response with the `200` status
- **2026-08-21** `edf928b9b745` — 2 info
  - added the optional property `integrations/items/base_config/invoice_sync_settings/metadata_custom_fields` to the response with the `200` status
  - added the optional property `integrations/items/current_config/invoice_sync_settings/metadata_custom_fields` to the response with the `200` status
- **2026-08-20** `562f13cf61dd` — 2 info
  - added the optional property `integrations/items/base_config/invoice_sync_settings/service_period_custom_fields` to the response with the `200` status
  - added the optional property `integrations/items/current_config/invoice_sync_settings/service_period_custom_fields` to the response with the `200` status
- **2026-08-14** `29f14678f58f` — 2 info
  - added the optional property `integrations/items/base_config/price` to the response with the `200` status
  - added the optional property `integrations/items/current_config/price` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/flexprice/apis/flexprice-api/changes/integrations/config/get.md)

---

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