---
title: "Connect a reporting integration"
method: POST
path: "/integrations/reporting/{provider}/connect"
tags: ["Integrations"]
---

# Connect a reporting integration

`POST /integrations/reporting/{provider}/connect`

## Request

- Base URL: `https://api.cavuno.com/v1`
- URL: `https://api.cavuno.com/v1/integrations/reporting/{provider}/connect`
- Auth: HTTP bearer

Starts the connection flow. Some providers return a hosted authorization URL, some connect immediately, and payment reporting returns the Board payments-settings URL. Provider credentials and configuration are never returned.

## Path parameters

- `provider` 'search_console' | 'adsense' | 'tinybird' | 'stripe' | 'google_analytics', required: The reporting provider key. `tinybird` is deprecated: first-party Board analytics need no connection and are served live by the `/v1/analytics` endpoints, so connecting it changes nothing.

## Response `200`

Successful response.

- ReportingConnect
  - `object` 'reporting_integration_connect', required: String representing the object's type.
  - `provider` string, required: The reporting provider key.
  - `connected` boolean, required: Whether the integration is already fully connected.
  - `authorizationUrl` string: OAuth providers only. The URL the user must visit to grant access.
  - `siteUrl` string: The board site URL the integration reports on.
  - `redirectUrl` string: Stripe only: the Monetization settings deep link.

## Other responses

- `default`: An error. Every non-2xx response uses the same envelope; see the Errors section of the introduction.

## Changes

- **2026-10-19** `c34152c38176`: 1 info
  - added the optional property `error/upgrade` to the response with the `default` status

[Operation history](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/changes/integrations/reporting/:provider/connect/post.md)

---

[API](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api.md) · [All operations](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/revisions/d5974dabff14?raw)