---
title: "Connector"
description: "the code for one source's ways and actions, with what it declares; one package of rows plus one implementation (18 §2.1)"
section: concepts
address: /concepts/connector
contract: 0476e35e6e275db5
---

# Connector

the code for one source's ways and actions, with what it declares; one package of rows plus one implementation (18 §2.1)

[figure: Connector is a row at platform scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | row |
| scope | platform |
| key | its name and the version of its code |
| store | postgres |
| family | sources |



## Fields


| field | type | required | note |
|---|---|---|---|
| `name` | `text` | yes |  |
| `source` | [Source](/concepts/source) | no | absent for a connector parameterized by its declarations, such as the browser capture, whose declarations each name theirs |
| `code_version` | `text` | yes |  |
| `declares` | `[text]` | yes | The names of the kinds of reading, the kinds of action and the capture declarations whose rows name this connector. The register build derives the list from those rows; nobody types it. |
| `behaviours` | `[one of probe \| read \| subscribe \| backfill \| act \| undo \| resolve \| capture]` | yes | the trait's behaviours the rows declare; one not implemented fails the build |
| `samples_hash` | `hash` | no | the recorded wire captures |
| `samples` | `{text:hash}` | no | for a connector that writes more than one shape (a catalogue builder whose views differ), the checked schema hash of each source object it returns, by the object's name; a connector that writes one shape records samples_hash alone |
| `sync_offers` | [SyncOffer](/concepts/syncoffer) | yes |  |
| `state` | [Readiness](/concepts/readiness) | yes |  |



## Routes that use it
No route takes or returns Connector directly. The record holds it, and the objects that point at it reach it.