HubSpot 자격 증명#

이 자격 증명을 사용하여 다음 노드를 인증할 수 있습니다:

지원하는 인증 방법#

앱 토큰: HubSpot 노드와 함께 사용합니다.
개발자 API 키: HubSpot Trigger 노드와 함께 사용합니다.
OAuth2: HubSpot 노드와 함께 사용합니다.

API 키 사용 중단

HubSpot은 일반적인 API 키 인증 방법을 사용 중단했습니다. 이 옵션은 여전히 n8n에 표시되지만, 위에 나열된 인증 방법을 대신 사용해야 합니다. 이 API 키 방법을 사용하는 기존 통합이 있는 경우 HubSpot의 API 키 통합을 개인 앱으로 마이그레이션하기 가이드를 참조하고 앱 토큰을 설정하세요.

앱 토큰 사용하기#

이 자격 증명을 구성하려면 HubSpot 계정 또는 HubSpot 개발자 계정이 필요하며:

앱 토큰

앱 토큰을 생성하려면 HubSpot에서 개인 앱을 생성하세요:

HubSpot 계정에서 기본 탐색 모음의 설정 아이콘을 선택합니다.
왼쪽 사이드바 메뉴에서 통합 > 개인 앱으로 이동합니다.
개인 앱 만들기를 선택합니다.
기본 정보 탭에서 앱의 이름을 입력합니다.
플레이스홀더 로고 위에 마우스를 올리고 업로드 아이콘을 선택하여 앱의 로고 역할을 할 정사각형 이미지를 업로드합니다.
앱에 대한 설명을 입력합니다.
범위 탭을 열고 적절한 범위를 추가합니다. 추가해야 할 범위의 전체 목록은 HubSpot 노드를 위한 필수 범위를 참조하세요.
앱 만들기를 선택하여 프로세스를 완료합니다.
모달에서 앱의 액세스 토큰에 대한 정보를 검토한 후 생성 계속하기를 선택합니다.
앱이 생성되면 액세스 토큰 카드를 열고 토큰 표시를 선택하여 토큰을 표시합니다.
이 토큰을 복사하고 n8n 자격 증명에 입력합니다.

자세한 내용은 HubSpot 개인 앱 문서를 참조하세요.

개발자 API 키 사용#

이 자격 증명을 구성하려면 HubSpot 개발자 계정이 필요합니다. 그리고:

클라이언트 ID: 공개 앱을 생성하면 생성됩니다.
클라이언트 비밀: 공개 앱을 생성하면 생성됩니다.
개발자 API 키: 개발자 앱 대시보드에서 생성됩니다.
앱 ID: 공개 앱을 생성하면 생성됩니다.

공개 앱을 만들고 자격 증명을 설정하려면:

HubSpot 앱 개발자 계정에 로그인합니다.
주요 탐색 표시줄에서 앱을 선택합니다.
HubSpot API 키 가져오기를 선택합니다. 키 표시 옵션을 선택해야 할 수도 있습니다.
키를 복사하여 n8n의 개발자 API 키에 입력합니다.
HubSpot 앱 페이지에서 앱 생성을 선택합니다.
앱 정보 탭에서 앱 이름, 설명, 로고 및 제공하고자 하는 모든 지원 연락처 정보를 추가합니다. 앱을 접하는 누구나 이를 보게 됩니다.
인증 탭을 엽니다.
앱 ID를 복사하여 n8n에 입력합니다.
클라이언트 ID를 복사하여 n8n에 입력합니다.
클라이언트 비밀을 복사하여 n8n에 입력합니다.
범위 섹션에서 새 범위 추가를 선택합니다.
HubSpot 트리거 노드에 대한 필수 범위에서 나열된 모든 범위를 앱에 추가합니다.
업데이트를 선택합니다.
n8n의 OAuth 리디렉션 URL을 복사하여 HubSpot 앱의 리디렉션 URL로 입력합니다.
HubSpot 앱 생성 완료를 위해 앱 생성을 선택합니다.

보다 자세한 지침은 HubSpot 공개 앱 문서를 참조하세요.

HubSpot 트리거 노드에 대한 필수 범위#

HubSpot 트리거 노드와 함께 사용할 앱을 만드는 경우 n8n은 다음 범위로 시작할 것을 권장합니다:

요소	객체	사용 권한	범위 이름
n/a	n/a	n/a	`oauth`
CRM	회사	읽기	`crm.objects.companies.read`
CRM	회사 스키마	읽기	`crm.schemas.companies.read`
CRM	연락처	읽기	`crm.objects.contacts.read`
CRM	연락처 스키마	읽기	`crm.schemas.contacts.read`
CRM	거래	읽기	`crm.objects.deals.read`
CRM	거래 스키마	읽기	`crm.schemas.deals.read`

/// 경고 | HubSpot 구 계정 일부 HubSpot 계정은 모든 범위에 접근할 수 없습니다. HubSpot은 계정을 점차적으로 마이그레이션하고 있습니다. 현재 HubSpot 개발자 계정에서 모든 범위를 찾을 수 없는 경우 새 개발자 계정을 생성해 보세요. ///

OAuth2 사용#

n8n Cloud 사용자 참고 사항

Cloud 사용자는 연결 정보를 직접 입력할 필요가 없습니다.
Connect my account 를 선택하면 브라우저를 통해 계정을 연결할 수 있습니다.

n8n을 자체 호스팅하는 경우 새 공개 앱을 생성하여 OAuth2를 처음부터 구성해야 합니다:

HubSpot 앱 개발자 계정에 로그인합니다.
주요 탐색 표시줄에서 앱을 선택합니다.
앱 생성을 선택합니다.
앱 정보 탭에서 앱 이름, 설명, 로고 및 제공하고자 하는 모든 지원 연락처 정보를 추가합니다. 앱을 접하는 누구나 이를 보게 됩니다.
인증 탭을 엽니다.
앱 ID를 복사하여 n8n에 입력합니다.
클라이언트 ID를 복사하여 n8n에 입력합니다.
클라이언트 비밀을 복사하여 n8n에 입력합니다.
범위 섹션에서 새 범위 추가를 선택합니다.
HubSpot 노드에 대한 필수 범위에서 나열된 모든 범위를 앱에 추가합니다.
업데이트를 선택합니다.
n8n의 OAuth 리디렉션 URL을 복사하여 HubSpot 앱의 리디렉션 URL로 입력합니다.
HubSpot 앱 생성을 마치기 위해 앱 생성을 선택합니다.

보다 자세한 지침은 HubSpot 공개 앱 문서를 참조하세요. OAuth 웹 흐름에서 발생하는 일에 대한 더 자세한 정보가 필요하면 HubSpot OAuth 작업 문서를 참조하세요.

HubSpot 노드에 필요한 범위#

HubSpot 노드와 함께 사용할 앱을 만들고 있다면, n8n에서는 다음 범위로 시작할 것을 권장합니다:

요소	객체	권한	범위 이름
n/a	n/a	n/a	`oauth`
n/a	n/a	n/a	`forms`
n/a	n/a	n/a	`tickets`
CRM	기업	읽기 쓰기	`crm.objects.companies.read` `crm.objects.companies.write`
CRM	기업 스키마	읽기	`crm.schemas.companies.read`
CRM	연락처 스키마	읽기	`crm.schemas.contacts.read`
CRM	연락처	읽기 쓰기	`crm.objects.contacts.read` `crm.objects.contacts.write`
CRM	거래	읽기 쓰기	`crm.objects.deals.read` `crm.objects.deals.write`
CRM	거래 스키마	읽기	`crm.schemas.deals.read`
CRM	소유자	읽기	`crm.objects.owners.read`
CRM	목록	쓰기	`crm.lists.write`

HubSpot 구형 계정

일부 HubSpot 계정은 모든 범위에 접근할 수 없습니다. HubSpot은 계정을 점진적으로 마이그레이션하고 있습니다. 현재 HubSpot 개발자 계정에서 모든 범위를 찾을 수 없다면, 새 개발자 계정을 생성해 보세요.

n8n 공식 기술 문서 한글판 by 인포그랩