---
title: "Fetch For Bronze"
method: POST
path: "/v1/integrations/fetch-for-bronze"
tags: ["integrations"]
---

# Fetch For Bronze

`POST /v1/integrations/fetch-for-bronze`

## Request

- Base URL: `https://api.evidenso.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.evidenso.com/v1/integrations/fetch-for-bronze`
- Auth: none declared

Fetch + shape integration data for a single source. Returns the
payload dict the corresponding digital-twin-api Bronze adapter's
`shape_payload()` accepts, plus the adapter slug + doc_type so the
caller can route into `run_bronze_ingest_sources()` directly.

A plain `def` endpoint: FastAPI runs it in its threadpool, so the
synchronous Composio SDK calls (and HubSpot's bounded parallel reads)
never block the event loop.

## Headers

- `authorization` string

## Request body

- FetchForBronzeRequest: Input for /fetch-for-bronze. Pipeline supplies the user's uid (so we can resolve their Composio user_id) plus the source slug being fetched.
  - `society_id` string, required: Composite 'market/name' identifier (digital-twin-api convention).
  - `source_slug` string, required: Composio toolkit slug, e.g. 'granola_mcp' or 'slack'.
  - `user_id` string, required: Firebase uid of the user the society is being created for. Used to resolve the Composio user_id scope.
  - `product_name` string: Optional product scope. Empty for org-level connections (the default for society-creation flows).
  - `internal_domains` string[]: Host org email domains, used by adapters to exclude internal participants from CLIENT-domain inference.
  - `scope` object: Per-source scope filter. Per-source shape: Slack `{mode, channel_ids?}`, Google `{mode, folder_ids?, file_ids?}`, Granola `{mode, meeting_ids?}`, Notion `{mode, page_ids?}`, HubSpot `{mode: 'selected', contact_ids: ['portalId:contactId']}` where `mode` is 'all' or 'selected' (HubSpot: 'selected' only).
  - `agent_payload_id` string: Id of an mcp_agent_document_payloads row holding documents the user's agent pre-extracted via its own integrations. Required when source_slug='agent_documents'; ignored for Composio-backed sources.

## Response `200`

Successful Response

- FetchForBronzeResponse
  - `adapter_slug` string, required: Slug used by `digital-twin-api/src/market_intelligence/bronze/connectors/__init__.py:get_adapter()`.
  - `doc_type` string, required
  - `payload` object, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/evidenso/apis/persona-rag-api.md) - [All operations](https://skmtc.dev/evidenso/apis/persona-rag-api/llms.txt) - [OpenAPI document](https://skmtc.dev/evidenso/apis/persona-rag-api/revisions/86408c178d4f?raw)