---
title: "List Audience Sources"
method: GET
path: "/api/audience_sources"
tags: ["sequences"]
---

# List Audience Sources

`GET /api/audience_sources`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/audience_sources`
- 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`

Return the registry of audience source kinds + their output columns.

Exposed so the MCP skill (and anyone else building on top) can discover
at runtime what sources exist, what each emits per lead, and what the
default config looks like — no hardcoded list in client code. When a
new source kind is added to beshared, this endpoint surfaces it
automatically.

## Response `200`

Successful Response

- AudienceSourcesResponse: Discoverable campaign audience-source catalog and qualification attributes.
  - `enrichment_attributes` AudienceEnrichmentAttributePayload[], required: Typed enrichment fields accepted by campaign qualification.
    - `attribute_type` 'string' | 'number', required: Value kind used to choose valid filter operators.
    - `key` string, required: Canonical enrichment field key.
    - `note` string, required: Operator and authoring guidance for this field.
    - `scope` 'company' | 'contact', required: Whether the field belongs to the company or contact entity.
  - `sources` AudienceSourceKindPayload[], required: Supported source adapters with exact defaults and output contracts.
    - `credit_rate_key` string, nullable, required: Published credit-meter rate key, or null when unmetered.
    - `default_config` object, required: Adapter-owned default configuration; preserve source_kind and edit documented keys only.
    - `default_display_name` string, required: Default human-readable source name.
    - `description` string, required: What the source acquires and when to use it.
    - `estimate_support` string, required: Whether provider-side count estimation is supported.
    - `form_key` string, required: Editor form discriminator for this source kind.
    - `hash_strategy` string, required: Canonical configuration hashing strategy used for preview adoption.
    - `kind` string, required: Canonical source_kind discriminator accepted by campaign source operations.
    - `legacy_block_type` string, required: Legacy workflow block name retained for existing editor revisions.
    - `output_columns` AudienceSourceOutputColumnPayload[], required: Canonical fields this source can emit per row.
      - `display_name` string, required: Human-readable field label shown in source previews.
      - `field_key` string, required: Canonical campaign field key produced by this source.
      - `source_key` string, required: Raw source-row key from which the canonical field is projected.
    - `preview_labels` AudienceSourcePreviewLabelsPayload, required: Human-readable labels and empty-state guidance for one source adapter preview.
      - `contact_singular` string, required: Singular label for one acquired contact.
      - `empty_hint` string, required: Message shown when the source returns no rows.
      - `show_source_count` boolean, required: Whether the preview should display a provider-side source count.
      - `source_item_singular` string, required: Singular label for one provider-side source item.
      - `streaming_hint` string, required: Message shown while source rows are still arriving.
    - `runtime_execution_support` string, required: Whether execution is unsupported, direct, or workflow-backed.
    - `scheduled_run_support` boolean, required: Whether recurring acquisition is supported.
    - `ui_state` string, required: Whether the source is enabled, preview-only, or unavailable.
    - `workflow_setting_key` string, nullable, required: Runtime workflow setting used by this adapter, or null.
  - `unsupported_facets` string[], required: Common requested facets no current source supplies directly.

---

[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)