---
title: <Integration name>
sidebar_position: <N>
---

# <Integration name> connector

<One-paragraph summary: what gets extracted, how (API/protocol), and what the
connector never does to the customer system (read-only guarantees).>

## Prerequisites

- <Tessera project + API key with `admin` scope>
- <What must exist on the customer side>

## Create the credential (least privilege)

<Exact steps to mint the narrowest credential that works, with the explicit
statement of why each grant is needed and what is deliberately NOT granted.>

## Create the source

<Copy-paste `POST /sources` body for this `kind`, tagged
config-validate so CI keeps it schema-true.>

## Map columns to canonical events

<The `PUT /sources/{id}/mapping` step: entity, event_type, timestamp,
attributes. Include a worked mapping for a realistic table.>

## Test the connection and run the first sync

<`POST /sources/{id}/test-connection` — name the checks it runs — then
`POST /sources/{id}/syncs` and how to verify landed rows.>

## Troubleshooting

| Symptom | Cause | Fix |
|---|---|---|
| <error> | <cause> | <fix> |