---
title: "Register AI Referrals Connection"
method: POST
path: "/{brand_id}/ai-referrals/connections"
tags: ["ai-referrals"]
---

# Register AI Referrals Connection

`POST /{brand_id}/ai-referrals/connections`

Register an AI Referrals push connection for a (brand, website, provider) tuple. Events can only be pushed once a connection exists.

A brand cannot have both a Google Analytics integration and an active AI Referrals push connection for the same website — the conflicting integration must be disabled first.

MVP provider allow-list: `adobe_analytics`.

## Path parameters

- `brand_id` integer, required

## Request body

- AiReferralsConnectionCreate — Payload to register a new AI Referrals connection.
  - `website` string, required — Hostname or URL of the website whose referrals will be pushed.
  - `provider` string, required — Source analytics provider. MVP allow-list: 'adobe_analytics'.

## Response `201`

Connection registered.

- AiReferralsConnection — A registered AI Referrals push connection.
  - `id` string, required — ULID identifier for the connection.
  - `brand_id` integer, required
  - `website` string, required — Hostname or URL of the website whose referrals are pushed against this connection.
  - `provider` string, required — Source analytics provider. MVP allow-list: 'adobe_analytics'.
  - `status` 'active' | 'disabled', required
  - `created_at` string, date-time, required
  - `last_pushed_at` string, date-time, nullable
  - `last_push_error` string, nullable

## Other responses

- `400` — Invalid provider or payload.
- `409` — A connection or conflicting integration already exists for this (brand, website).
- `422` — Validation Error

---

[API](https://skmtc.net/scrunch/apis/scrunch-data-api.md) · [All operations](https://skmtc.net/scrunch/apis/scrunch-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scrunch/scrunch-data-api/revisions/3e09c2a06458/schema)