HubSpot 자격 증명
이 자격 증명을 사용하여 다음 노드를 인증할 수 있습니다: HubSpot은 일반 API Key 인증 방법을 더 이상 사용하지 않습니다. HubSpot은 UI에서 생성된 프라이빗 앱을 레거시 상태로 전환했습니다. 서비스에 대한 자세한 내용은 HubSpot의 API 문서를 참조하세요.
이 자격 증명을 사용하여 다음 노드를 인증할 수 있습니다:
지원되는 인증 방법#
- Service key (권장): HubSpot 노드와 함께 사용합니다.
- Developer API key: HubSpot Trigger 노드와 함께 사용합니다.
- OAuth2: HubSpot 노드와 함께 사용합니다.
HubSpot은 일반 API Key 인증 방법을 더 이상 사용하지 않습니다. 옵션은 n8n에 여전히 표시되지만 위에 나열된 인증 방법을 대신 사용해야 합니다. 이 API 키 방법을 사용하는 기존 통합이 있는 경우 HubSpot의 API 키 통합을 프라이빗 앱으로 마이그레이션 가이드를 참조하고 서비스 키를 설정하세요.
HubSpot은 UI에서 생성된 프라이빗 앱을 레거시 상태로 전환했습니다. 이 유형의 앱에서 프라이빗 앱 액세스 토큰을 사용하고 있다면 HubSpot은 대신 서비스 키 사용을 권장합니다. 자세한 내용은 HubSpot의 Private Apps 문서를 참조하세요.
관련 리소스#
서비스에 대한 자세한 내용은 HubSpot의 API 문서를 참조하세요. HubSpot Trigger 노드는 Webhooks API를 사용합니다. 해당 서비스에 대한 자세한 내용은 HubSpot의 Webhooks API 문서를 참조하세요.
Service Key 사용#
이 자격 증명을 구성하려면 슈퍼 관리자 접근 권한 또는 Developer tools 접근 권한이 있는 HubSpot 계정과 다음이 필요합니다:
- Service Key
서비스 키를 생성하려면:
-
HubSpot 계정에서 Development > Keys > Service Keys로 이동합니다. (Settings > Account Management > Integrations > Service Keys 아래에서도 찾을 수 있습니다.)
-
Create service key를 선택합니다.
-
키에 대한 설명이 있는 Name을 입력합니다.
-
Add new scope를 선택하고 통합에 필요한 권한을 선택합니다. 권장 스코프 목록은 HubSpot 노드에 필요한 스코프를 참조하세요.
-
Update를 선택하여 스코프 선택을 확인합니다.
-
Create를 선택한 다음 대화 상자에서 확인합니다.
-
새 서비스 키 이름을 클릭하여 세부 정보 페이지로 이동하고 Show를 선택하여 키를 표시합니다.
-
복사 버튼을 사용하여 키 값을 복사하고 n8n 자격 증명의 App Token에 붙여넣습니다.
서비스 키는 현재 공개 베타 단계에 있으며 변경될 수 있습니다. 최신 정보는 HubSpot의 Service Keys 문서를 참조하세요.
Developer API key 사용#
이 자격 증명을 구성하려면 HubSpot developer 계정과 다음이 필요합니다:
- Client ID: 공개 앱을 생성하면 생성됩니다.
- Client Secret: 공개 앱을 생성하면 생성됩니다.
- Developer API Key: Developer Apps 대시보드에서 생성됩니다.
- App ID: 공개 앱을 생성하면 생성됩니다.
공개 앱을 생성하고 자격 증명을 설정하려면:
- HubSpot 앱 개발자 계정에 로그인합니다.
- 기본 탐색 바에서 Apps를 선택합니다.
- Get HubSpot API key를 선택합니다. Show key 옵션을 선택해야 할 수도 있습니다.
- 키를 복사하여 n8n의 Developer API Key로 입력합니다.
- HubSpot Apps 페이지에서 Create app을 선택합니다.
- App Info 탭에서 App name, Description, Logo 및 제공하려는 지원 연락처 정보를 추가합니다. 앱을 접하는 모든 사람이 이를 보게 됩니다.
- Auth 탭을 엽니다.
- App ID를 복사하여 n8n에 입력합니다.
- Client ID를 복사하여 n8n에 입력합니다.
- Client Secret을 복사하여 n8n에 입력합니다.
- Scopes 섹션에서 Add new scope를 선택합니다.
- HubSpot Trigger 노드에 필요한 스코프에 나열된 모든 스코프를 앱에 추가합니다.
- Update를 선택합니다.
- n8n OAuth Redirect URL을 복사하여 HubSpot 앱의 Redirect URL로 입력합니다.
- Create app을 선택하여 HubSpot 앱 생성을 완료합니다.
자세한 지침은 HubSpot Public Apps 문서를 참조하세요.
HubSpot Trigger 노드에 필요한 스코프#
HubSpot Trigger 노드와 함께 사용할 앱을 생성하는 경우 n8n은 다음 스코프로 시작하도록 권장합니다:
| 요소 | 객체 | 권한 | 스코프 이름 |
|---|---|---|---|
| n/a | n/a | n/a | oauth |
| CRM | Companies | Read | crm.objects.companies.read |
| CRM | Companies schemas | Read | crm.schemas.companies.read |
| CRM | Contacts | Read | crm.objects.contacts.read |
| CRM | Contacts schemas | Read | crm.schemas.contacts.read |
| CRM | Deals | Read | crm.objects.deals.read |
| CRM | Deals schemas | Read | crm.schemas.deals.read |
OAuth2 사용#
Cloud 사용자는 연결 정보를 제공할 필요가 없습니다. **내 계정 연결(Connect my account)**을 선택하여 브라우저를 통해 연결하세요.
n8n을 셀프 호스팅하는 경우 새 공개 앱을 생성하여 처음부터 OAuth2를 구성해야 합니다:
- HubSpot 앱 개발자 계정에 로그인합니다.
- 기본 탐색 바에서 Apps를 선택합니다.
- Create app을 선택합니다.
- App Info 탭에서 App name, Description, Logo 및 제공하려는 지원 연락처 정보를 추가합니다. 앱을 접하는 모든 사람이 이를 보게 됩니다.
- Auth 탭을 엽니다.
- App ID를 복사하여 n8n에 입력합니다.
- Client ID를 복사하여 n8n에 입력합니다.
- Client Secret을 복사하여 n8n에 입력합니다.
- Scopes 섹션에서 Add new scope를 선택합니다.
- HubSpot 노드에 필요한 스코프에 나열된 모든 스코프를 앱에 추가합니다.
- Update를 선택합니다.
- n8n OAuth Redirect URL을 복사하여 HubSpot 앱의 Redirect URL로 입력합니다.
- Create app을 선택하여 HubSpot 앱 생성을 완료합니다.
자세한 지침은 HubSpot Public Apps 문서를 참조하세요. 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 | Companies | Read Write |
crm.objects.companies.read crm.objects.companies.write |
| CRM | Companies schemas | Read | crm.schemas.companies.read |
| CRM | Contacts schemas | Read | crm.schemas.contacts.read |
| CRM | Contacts | Read Write |
crm.objects.contacts.read crm.objects.contacts.write |
| CRM | Deals | Read Write |
crm.objects.deals.read crm.objects.deals.write |
| CRM | Deals schemas | Read | crm.schemas.deals.read |
| CRM | Owners | Read | crm.objects.owners.read |
| CRM | Lists | Write | crm.lists.write |