> ## Documentation Index > Fetch the complete documentation index at: https://docs.costgraph.ai/llms.txt > Use this file to discover all available pages before exploring further. # Connect a provider that CostGraph pulls billing data from > Verifies the credentials by reading a day of billing data, then stores them encrypted and schedules a daily pull. Send exactly one of env with the provider's settings, credential_source_connection_id naming an existing connection in the same tenant whose credential this one reuses (the provider's credential_from lists which providers qualify), or, for providers marked github_app, github_app_installation_id naming an installation of the CostGraph GitHub App connected to the same tenant, through which CostGraph mints a read-only token on every sync. GitHub connects only through the GitHub App, and connecting it also connects GitHub Actions jobs for the same organization; providers with managed_by set cannot be connected on their own. Blacksmith connects only when GitHub is connected for the same organization in the tenant. enable_recommendations (default true) turns savings recommendations off for providers that have them. Credentials are never returned. ## OpenAPI ````yaml /api-reference/costgraph/openapi.json post /api/v1/integrations/focus/connect openapi: 3.0.0 info: description: Read and manage your CostGraph organization, spend, alerts, and settings. title: CostGraph API contact: {} version: '1.0' servers: - url: https://api.costgraph.ai security: [] tags: - name: ai x-group: AI - name: ai-serving x-group: AI serving - name: anomalies x-group: Anomalies - name: auth x-group: Auth - name: billing x-group: Billing - name: billing-export x-group: Billing export - name: budgets x-group: Budgets - name: ci x-group: CI - name: compute-recommendations x-group: Compute recommendations - name: config x-group: Config - name: cost x-group: Cost - name: gpus x-group: GPUs - name: graphai x-group: Graph AI - name: infracost x-group: Infracost - name: integrations x-group: Integrations - name: invitations x-group: Invitations - name: kubernetes-clusters x-group: Kubernetes clusters - name: marketplace x-group: Marketplace - name: network-requests x-group: Network requests - name: notifications x-group: Notifications - name: oauth x-group: OAuth - name: oauth-clients x-group: OAuth clients - name: opencost x-group: OpenCost - name: organization x-group: Audit log - name: organizations x-group: Organizations - name: placement-alternatives x-group: Placement alternatives - name: reports x-group: Reports - name: service-map x-group: Service map - name: settings x-group: Settings - name: sso x-group: Single sign-on - name: tenants x-group: Tenants - name: user x-group: Users - name: virtual-machines x-group: Virtual machines - name: virtual-tags x-group: Virtual tags - name: workflows x-group: Workflows paths: /api/v1/integrations/focus/connect: post: tags: - integrations summary: Connect a provider that CostGraph pulls billing data from description: >- Verifies the credentials by reading a day of billing data, then stores them encrypted and schedules a daily pull. Send exactly one of env with the provider's settings, credential_source_connection_id naming an existing connection in the same tenant whose credential this one reuses (the provider's credential_from lists which providers qualify), or, for providers marked github_app, github_app_installation_id naming an installation of the CostGraph GitHub App connected to the same tenant, through which CostGraph mints a read-only token on every sync. GitHub connects only through the GitHub App, and connecting it also connects GitHub Actions jobs for the same organization; providers with managed_by set cannot be connected on their own. Blacksmith connects only when GitHub is connected for the same organization in the tenant. enable_recommendations (default true) turns savings recommendations off for providers that have them. Credentials are never returned. requestBody: content: application/json: schema: $ref: '#/components/schemas/focus.pullConnectRequest' description: Provider connection required: true responses: '201': description: Created content: application/json: schema: $ref: '#/components/schemas/responses.SuccessResponse' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/responses.ErrorResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/responses.ErrorResponse' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/responses.ErrorResponse' security: - BearerAuth: [] components: schemas: focus.pullConnectRequest: type: object required: - provider - tenant_id properties: credential_source_connection_id: type: string display_name: type: string enable_recommendations: type: boolean env: type: object additionalProperties: type: string github_app_installation_id: type: integer provider: type: string provider_account_id: type: string tenant_id: type: string responses.SuccessResponse: type: object required: - message - status properties: data: {} message: type: string example: some message status: type: string example: success responses.ErrorResponse: type: object required: - message - status properties: message: type: string example: some message status: type: string example: error securitySchemes: BearerAuth: description: Enter "Bearer {token}" type: apiKey name: Authorization in: header ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.