---
title: HubSpot으로 데이터 전송
description: 정확한 권한 범위, 일치 기준, 안전한 생성을 사용해 모델 행을 HubSpot 회사나 연락처에 매핑합니다.
species: guide
---
# HubSpot으로 데이터 전송

Supernova는 HubSpot `companies`와 `contacts`를 업데이트하거나 생성할 수 있습니다. 새 전송은 기본적으로 `hs_object_id`로 일치 여부를 확인합니다. 이는 HubSpot에서 동기화한 행에 이미 있는 안정적인 ID입니다.

## 필요한 액세스

| 객체 | 쓰기 범위 | 기본 일치 속성 |
|---|---|---|
| 회사 | `crm.objects.companies.write` | `hs_object_id` |
| 연락처 | `crm.objects.contacts.write` | `hs_object_id` |

소스 자격 증명에 선택한 객체의 쓰기 범위가 없으면 HubSpot을 다시 연결하세요. 읽기 권한만으로 테이블을 동기화할 수는 있지만 전송을 허용할 수는 없습니다.

## 모델 만들기

일치 ID와 모든 전송 값을 명시적으로 지정합니다.

```sql
select
  property_hs_object_id as hs_object_id,
  customer_tier,
  renewal_date
from titan.analytics.customer_health
where property_hs_object_id is not null
```

먼저 일치 속성을 선택한 뒤 `customer_tier`와 `renewal_date`를 쓰기 가능한 HubSpot 속성에 매핑합니다. 계산된 속성과 대상이 관리하는 속성은 매핑에서 제외됩니다.

열거형 매핑은 표시 레이블이 아니라 옵션의 내부 값을 보냅니다. 날짜, 숫자, 불리언은 요청 전에 HubSpot의 전송 형식으로 변환됩니다.

## 미리보기와 확인

미리보기는 업데이트, 생성, 모호한 일치, 유효하지 않은 행을 구분합니다. 모든 모델 행이 이미 동기화된 HubSpot 레코드를 나타내야 한다면 생성을 꺼두세요.

쓰기에 성공하면 Supernova는 영향을 받은 수신 테이블을 다시 읽어 대상 값을 레이크에 반영합니다. 전송은 생성 당시의 HubSpot 계정에 계속 고정됩니다.