---
title: "Connection data model"
url: "https://docs.unified.to/unified/connection/model"
description: "API reference for Connection data model. Launch multiple pre-built Connection integrations today with zero maintenance — all through a single API."
generated_at: "2026-06-30T19:54:44.801Z"
---
# Connection data model

A connection represents a specific authentication of an integration.

### 

* Data Model
* Typescript Type
* Zod Shape
* Python Class

Data Model

**id**string  read-only 

Unique identifier for this integration object

**created\_at**date  read-only 

The date that this integration object was created (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**updated\_at**date  read-only 

The last date that this integration object was updated (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**workspace\_id**string  read-only 

(reference to KmsSpace)

**integration\_type**string  required 

The integration type

**integration\_name**string 

**external\_xref**string 

customer's user ID

**permissions** enum array  required 

Valid values:

 "accounting\_account\_read" 

 "accounting\_account\_write" 

 "accounting\_transaction\_read" 

 "accounting\_transaction\_write" 

 "accounting\_journal\_read" 

**categories** enum array  required 

Valid values:

 "passthrough" 

 "hris" 

 "ats" 

 "auth" 

 "crm" 

The Integration categories that this connection supports

**auth**object 

An authentication object that represents a specific authorized user's connection to an integration.

**is\_paused**boolean  read-only 

Whether this integration has exceed the monthly limit of the plan

**environment**string 

**last\_healthy\_at**date  read-only 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**last\_unhealthy\_at**date  read-only 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**secretsmanager\_id**string 

the ID of the SecretsManager object

**secretsmanager\_key**string 

the key/path/name of the secret within the vault