> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.jp/docs/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve errors for a specific import > 特定のインポート処理の詳しいエラーレコードを取得し、処理中に失敗したレコードを特定してトラブルシューティングできるようにします。 export const ScopesList = ({scopes = [], description = "この API には、次のいずれかのスコープが必要です。"}) => { if (!scopes || scopes.length === 0) { return null; } const sortedScopes = scopes.sort((a, b) => a.localeCompare(b)); return
{description}
{sortedScopes.map((scope, index) =>
{scope}
)}
; }; export const SupportedProducts = ({marketing, sales, service, cms, marketingLevel, salesLevel, serviceLevel, cmsLevel}) => { const translations = { header: "サポートされる製品", description: "次のいずれかの製品またはそれ以上が必要です。", productNames: { marketing: "Marketing Hub", sales: "Sales Hub", service: "Service Hub", cms: "Content Hub" }, tiers: { free: "無料ツール", starter: "Starter", professional: "Professional", enterprise: "Enterprise" } }; const translateTier = tier => { if (!tier) return ''; const lowerTier = tier.toLowerCase(); return translations.tiers[lowerTier] || tier; }; const products = [{ name: marketing ? translations.productNames.marketing : '', level: translateTier(marketingLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/marketing-bolt.svg", alt: "Marketing Hub" }, { name: sales ? translations.productNames.sales : '', level: translateTier(salesLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/sales-star.svg", alt: "Sales Hub" }, { name: service ? translations.productNames.service : '', level: translateTier(serviceLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/service-heart.svg", alt: "Service Hub" }, { name: cms ? translations.productNames.cms : '', level: translateTier(cmsLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/content-play.svg", alt: "Content Hub" }].filter(product => product.name && product.level); if (products.length === 0) return null; return
{translations.description}
{products.map((product, index) =>
{product.alt} {product.name} - {product.level}
)}
; }; ## OpenAPI ````yaml specs/2026-03/crm-imports-v2026-03.json GET /crm/imports/2026-03/{importId}/errors openapi: 3.0.1 info: title: CRM Imports description: Basepom for all HubSpot Projects version: 2026-03 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE servers: - url: https://api.hubapi.com security: [] tags: - name: Advanced - name: Basic paths: /crm/imports/2026-03/{importId}/errors: get: tags: - Basic summary: 特定のインポートのエラーを取得 description: 特定のインポート処理の詳しいエラーレコードを取得し、処理中に失敗したレコードを特定してトラブルシューティングできるようにします。 operationId: >- get-/crm/imports/2026-03/{importId}/errors_/crm/imports/v3/{importId}/errors parameters: - name: importId in: path description: '' required: true style: simple explode: false schema: type: integer format: int64 - name: after in: query description: >- 最後に正常に読み取られたリソースのページ操作カーソルトークンは、より多くの結果を含むページ付きレスポンスのpaging.next.after JSONプロパティーとして返されます。 required: false style: form explode: true schema: type: string - name: includeErrorMessage in: query description: '' required: false style: form explode: true schema: type: boolean - name: includeRowData in: query description: '' required: false style: form explode: true schema: type: boolean - name: limit in: query description: ページごとに表示する結果の最大数。 required: false style: form explode: true schema: type: integer format: int32 responses: '200': description: successful operation content: application/json: schema: $ref: >- #/components/schemas/CollectionResponsePublicImportErrorForwardPaging default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - crm.import components: schemas: CollectionResponsePublicImportErrorForwardPaging: required: - results type: object properties: paging: $ref: '#/components/schemas/ForwardPaging' results: type: array items: $ref: '#/components/schemas/PublicImportError' ForwardPaging: type: object properties: next: $ref: '#/components/schemas/NextPage' PublicImportError: required: - createdAt - errorType - id - sourceData type: object properties: createdAt: type: integer description: エラーが記録された時点のエポックミリ秒のタイムスタンプ。 format: int64 errorMessage: type: string description: 人間が読めるエラーメッセージ。 errorType: type: string description: インポート処理中に発生した問題の分類。 enum: - AMBIGUOUS_ENUMERATION_OPTION - ASSOCIATION_LABEL_NOT_FOUND - ASSOCIATION_LIMIT_EXCEEDED - ASSOCIATION_RECORD_NOT_FOUND - COLUMN_TOO_LARGE - COULD_NOT_FIND_BUSINESS_UNIT - COULD_NOT_FIND_OWNER - COULD_NOT_PARSE_DATE - COULD_NOT_PARSE_NUMBER - COULD_NOT_PARSE_ROW - COULD_NOT_PARSE_TERM - CREATE_ONLY_IMPORT - DUPLICATE_ALTERNATE_ID - DUPLICATE_ASSOCIATION_ID - DUPLICATE_EVENT - DUPLICATE_OBJECT_ID - DUPLICATE_RECORD_ID - DUPLICATE_ROW_CONTENT - DUPLICATE_UNIQUE_CREATION_KEY - DUPLICATE_UNIQUE_PROPERTY_VALUE - FAILED_TO_CREATE_ASSOCIATION - FAILED_TO_FIND_RECORD_FOR_ASSOCIATIONS - FAILED_TO_OPT_OUT_CONTACT - FAILED_TO_PROCESS_OBJECT_WITH_EMPTY_PROPERTY_VALUES - FAILED_VALIDATION - FILE_NOT_FOUND - GDPR_BLACKLISTED_EMAIL - INCORRECT_NUMBER_OF_COLUMNS - INVALID_ALTERNATE_ID - INVALID_ASSOCIATION_IDENTIFIER - INVALID_ASSOCIATION_KEY - INVALID_COLUMN_CONFIGURATION - INVALID_CUSTOM_PROPERTY_VALIDATION - INVALID_DOMAIN - INVALID_EMAIL - INVALID_ENUM_FILE_ID_OR_URL - INVALID_ENUMERATION_OPTION - INVALID_EVENT - INVALID_EVENT_TIMESTAMP - INVALID_FILE_TYPE - INVALID_NUMBER_SIZE - INVALID_OBJECT_ID - INVALID_PROPERTY_VALUE_FORMAT - INVALID_RECORD_ID - INVALID_REQUIRED_PROPERTY - INVALID_SHEET_COUNT - INVALID_SPREADSHEET - LIMIT_EXCEEDED - LINE_ITEM_MULTIPLE_PARENTS_IN_ROW - MANY_ERRORS_IN_ROW - MISSING_EVENT_DEFINITION - MISSING_EVENT_TIMESTAMP - MISSING_OBJECT_DEFINITION - MISSING_REQUIRED_PROPERTY - MULTIPLE_COMPANIES_WITH_THIS_DOMAIN - MULTIPLE_OWNERS_FOUND - NO_OBJECT_ID_FROM_ASSOCIATION_IDENTIFIER - OUTSIDE_VALID_TERM_RANGE - OUTSIDE_VALID_TIME_RANGE - PORTAL_WIDE_CUSTOM_OBJECT_LIMIT_EXCEEDED - PROPERTY_DEFINITION_NOT_FOUND - PROPERTY_VALUE_NOT_FOUND - ROW_DATA_TOO_LARGE - SECONDARY_EMAIL_WRITE_FAILURE - UNKNOWN_ASSOCIATION_RECORD_ID - UNKNOWN_BAD_REQUEST - UNKNOWN_ERROR - UPDATE_ONLY_IMPORT extraContext: type: string description: エラーに関する人間が読める追加のコンテキスト。 id: type: string description: この特定のエラーの固有の安定したID。 invalidPropertyValue: $ref: '#/components/schemas/PropertyValue' invalidValue: type: string description: 検証失敗の原因となったインポートファイルからの素のままの文字列値。 invalidValueToDisplay: type: string description: >- 「invalidPropertyValue」または「invalidValue」のいずれか存在する方（プロパティー値が優先）からの値を返す利便性アクセサー。 knownColumnNumber: type: integer description: エラーが発生したインポートファイルにおける0から始まる列インデックス format: int32 objectType: type: string description: このエラーの影響を受けたCRMオブジェクトタイプ。 enum: - ABANDONED_CART - ACCEPTANCE_TEST - AD - AD_ACCOUNT - AD_CAMPAIGN - AD_GROUP - AI_FORECAST - ALL_PAGES - APPROVAL - APPROVAL_STEP - ATTRIBUTION - AUDIENCE - AUTOMATION_JOURNEY - AUTOMATION_PLATFORM_FLOW - AUTOMATION_PLATFORM_FLOW_ACTION - BET_ALERT - BET_DELIVERABLE_SERVICE - BLOG_LISTING_PAGE - BLOG_POST - CALL - CAMPAIGN - CAMPAIGN_BUDGET_ITEM - CAMPAIGN_SPEND_ITEM - CAMPAIGN_STEP - CAMPAIGN_TEMPLATE - CAMPAIGN_TEMPLATE_STEP - CART - CASE_STUDY - CHATFLOW - CLIP - CMS_URL - COMBO_EVENT_CONFIGURATION - COMMERCE_PAYMENT - COMMUNICATION - COMPANY - CONTACT - CONTACT_CREATE_ATTRIBUTION - CONTENT - CONTENT_AUDIT - CONTENT_AUDIT_PAGE - CONVERSATION - CONVERSATION_INBOX - CONVERSATION_SESSION - CRM_OBJECTS_DUMMY_TYPE - CRM_PIPELINES_DUMMY_TYPE - CTA - CTA_VARIANT - DATA_PRIVACY_CONSENT - DATA_SYNC_STATE - DEAL - DEAL_CREATE_ATTRIBUTION - DEAL_REGISTRATION - DEAL_SPLIT - DISCOUNT - DISCOUNT_CODE - DISCOUNT_TEMPLATE - EMAIL - ENGAGEMENT - EXPORT - EXTERNAL_WEB_URL - FEE - FEEDBACK_SUBMISSION - FEEDBACK_SURVEY - FILE_MANAGER_FILE - FILE_MANAGER_FOLDER - FOLDER - FORECAST - FORM - FORM_SUBMISSION_INBOUNDDB - GOAL_TARGET - GOAL_TARGET_GROUP - GOAL_TEMPLATE - GSC_PROPERTY - HUB - IMPORT - INVOICE - KEYWORD - KNOWLEDGE_ARTICLE - LANDING_PAGE - LEAD - LINE_ITEM - MARKETING_CALENDAR - MARKETING_CAMPAIGN_UTM - MARKETING_EMAIL - MARKETING_EVENT - MARKETING_EVENT_ATTENDANCE - MARKETING_SMS - MEDIA_BRIDGE - MEETING_EVENT - MIC - NOTE - OBJECT_LIST - ORDER - OWNER - PARTNER_ACCOUNT - PARTNER_CLIENT - PARTNER_CLIENT_REVENUE - PARTNER_SERVICE - PAYMENT_LINK - PAYMENT_SCHEDULE - PAYMENT_SCHEDULE_INSTALLMENT - PERMISSIONS_TESTING - PLAYBOOK - PLAYBOOK_QUESTION - PLAYBOOK_SUBMISSION - PLAYBOOK_SUBMISSION_ANSWER - PLAYLIST - PLAYLIST_FOLDER - PODCAST_EPISODE - PORTAL - PORTAL_OBJECT_SYNC_MESSAGE - POSTAL_MAIL - PRIVACY_SCANNER_COOKIE - PRODUCT - PRODUCT_OR_FOLDER - PROPERTY_INFO - PROSPECTING_AGENT_CONTACT_ASSIGNMENT - PUBLISHING_TASK - QUARANTINED_SUBMISSION - QUOTA - QUOTE - QUOTE_FIELD - QUOTE_MODULE - QUOTE_MODULE_FIELD - QUOTE_TEMPLATE - RESTORABLE_CRM_OBJECT - ROSTER - ROSTER_MEMBER - SALES_DOCUMENT - SALES_TASK - SALES_WORKLOAD - SALESFORCE_SYNC_ERROR - SCHEDULING_PAGE - SCHEMAS_BACKEND_TEST - SCORE_CONFIGURATION - SEQUENCE - SEQUENCE_ENROLLMENT - SEQUENCE_STEP - SEQUENCE_STEP_ENROLLMENT - SERVICE - SITE_PAGE - SNIPPET - SOCIAL_BROADCAST - SOCIAL_CHANNEL - SOCIAL_POST - SOCIAL_PROFILE - SOX_PROTECTED_DUMMY_TYPE - SOX_PROTECTED_TEST_TYPE - SUBMISSION_TAG - SUBSCRIPTION - TASK - TASK_TEMPLATE - TAX - TEMPLATE - TICKET - UNKNOWN - UNSUBSCRIBE - USER - VIEW - VIEW_BLOCK - WEB_INTERACTIVE objectTypeId: type: string description: このエラーの影響を受けたCRMオブジェクトのモダンなオブジェクトタイプID。 sourceData: $ref: '#/components/schemas/ImportRowCore' Error: required: - category - correlationId - message type: object properties: category: type: string description: エラーカテゴリー context: type: object additionalProperties: type: array items: type: string description: エラー条件に関する背景状況 example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: リクエストの固有ID。エラー報告またはサポートチケットには必ずこの値を含めてください format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: エラーに関する詳細情報 items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: エラーまたは推奨の修正手順に関するドキュメントが含まれる関連付けられたURIへのリンク名の対応付け message: type: string description: エラーと修正手順（該当する場合）を記した、人が理解できるメッセージ example: An error occurred subCategory: type: string description: エラーに関する具体的な詳細が含まれる特定のカテゴリー example: message: Invalid input (details will vary based on the error) correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf category: VALIDATION_ERROR links: knowledge-base: https://www.hubspot.com/products/service/knowledge-base NextPage: required: - after type: object properties: after: type: string description: A paging cursor token for retrieving subsequent pages. link: type: string description: A URL that can be used to retrieve the next page results. description: >- Specifies the paging information needed to retrieve the next set of results in a paginated API response PropertyValue: required: - dataSensitivity - isEncrypted - isLargeValue - name - persistenceTimestamp - requestId - selectedByUser - selectedByUserTimestamp - source - sourceId - sourceLabel - sourceMetadata - sourceUpstreamDeployable - sourceVid - timestamp - unit - updatedByUserId - useTimestampAsPersistenceTimestamp - value type: object properties: dataSensitivity: type: string description: >- The sensitivity level of the property, such as "non_sensitive", "sensitive", and "highly_sensitive". enum: - high - none - standard isEncrypted: type: boolean description: Whether the property value is encrypted. isLargeValue: type: boolean description: 値が通常のサイズの上限を超えるかどうかを示します。 name: type: string description: The unique property name. persistenceTimestamp: type: integer description: 値がデータベースに保存された時点（エポックミリ秒）。 format: int64 requestId: type: string description: A unique ID associated with this request. selectedByUser: type: boolean description: Whether the value was selected by a user. selectedByUserTimestamp: type: integer description: The timestamp when the value was selected by a user, if applicable. format: int64 source: type: string description: The origin of the property value, such as "IMPORT" or "API". enum: - ACADEMY - ACCEPTANCE_TEST - ACTIVITY_AUTO_ASSOCIATE - ACTIVITY_LOG_REVERT - ADS - AI_GROUP - ANALYTICS - API - APPROVALS - ASSISTS - ASSOCIATIONS - AUTO_ASSOCIATE_BY_DOMAIN - AUTOMATION_JOURNEY - AUTOMATION_PLATFORM - AVATARS_SERVICE - BATCH_UPDATE - BCC_TO_CRM - BEHAVIORAL_EVENTS - BET_ASSIGNMENT - BET_CRM_CONNECTOR - BIDEN - BILLING - BOT - BREEZE_AGENT - CALCULATED - CENTRAL_EXCHANGE_RATES - CHATSPOT - CLONE_OBJECTS - COMMUNICATOR - COMPANIES - COMPANY_FAMILIES - COMPANY_INSIGHTS - CONNECTED_ACCOUNT - CONTACTS - CONTACTS_WEB - CONTENT_MEMBERSHIP - CONVERSATIONAL_ENRICHMENT - CONVERSATIONS - CRM_PROCESSES_PLATFORM - CRM_UI - CRM_UI_BULK_ACTION - CUSTOMER_AGENT - CUSTOMER_PORTAL - DATA_ENRICHMENT - DATA_QUALITY - DATASET - DEALS - DEFAULT - DELETE_OBJECTS - DI_WRITE_TO_CRM - EMAIL - EMAIL_INBOX_IMPORT - EMAIL_INTEGRATION - ENGAGEMENTS - EXTENSION - FILE_MANAGER - FLYWHEEL_PRODUCT_DATA_SYNC - FORECASTING - FORM - FORWARD_TO_CRM - GMAIL_INTEGRATION - GOALS - HEISENBERG - HELP_DESK - HELP_DESK_AI - IMPORT - INTEGRATION - INTEGRATIONS_PLATFORM - INTEGRATIONS_SYNC - INTENT - INTERNAL_PROCESSING - LEADIN - LEGAL_BASIS_REMEDIATION - MARKET_SOURCING - MARKETPLACE - MARKETS - MEETINGS - MERGE_COMPANIES - MERGE_CONTACTS - MERGE_OBJECTS - MERGE_REVERT_OBJECTS - MICROAPPS - MIGRATION - MOBILE_ANDROID - MOBILE_IOS - PAYMENTS - PIPELINE_SETTINGS - PLAYBOOKS - PORTAL_OBJECT_SYNC - PORTAL_USER_ASSOCIATOR - PRESENTATIONS - PRIMARY_AUTOMATION - PROPERTY_DEFAULT_VALUE - PROPERTY_RESTORE - PROPERTY_SETTINGS - PROSPECTING_AGENT - QUOTAS - QUOTES - RECYCLING_BIN - RESTORE_OBJECTS - REVENUE_PLATFORM - SALES - SALES_MESSAGES - SALESFORCE - SEQUENCES - SETTINGS - SIDEKICK - SIGNALS - SLACK_INTEGRATION - SMART_DATA_CAPTURE - SOCIAL - SUCCESS - TALLY - TASK - UNKNOWN - WAL_INCREMENTAL - WORK_UI - WORKFLOW_CONTACT_DELETE_ACTION - WORKFLOWS sourceId: type: string description: The ID of the property source indicating where it was created. sourceLabel: type: string description: A human-readable label. sourceMetadata: type: string description: Metadata providing additional context about the source. sourceUpstreamDeployable: type: string sourceVid: type: array description: The unique identifier associated with the source. items: type: integer format: int64 timestamp: type: integer description: When the value was set, as a 64-bit integer. format: int64 unit: type: string description: The unit of measurement or context for the value. updatedByUserId: type: integer description: The ID of the user who updated the property. format: int32 useTimestampAsPersistenceTimestamp: type: boolean description: タイムスタンプフィールドを保存タイムスタンプとして使用するかどうかを示すフラグ。 value: type: string description: The property value. description: >- Represents a single custom property of a marketing event, storing its name, value, metadata (like source, timestamp, and sensitivity), and related audit information for tracking changes. ImportRowCore: required: - additionalRowData - containsEncryptedProperties - fileId - lineNumber - rowData type: object properties: additionalRowData: type: array items: type: string containsEncryptedProperties: type: boolean description: この行に暗号化された値が含まれるかどうかを示します。 fileId: type: integer description: この行が含まれるアップロードされたファイルの固有ID。 format: int64 lineNumber: type: integer description: ソースファイル内におけるこの行の1から始まる行番号。行番号0は特定の行に対応しないファイル全体のエラーのために予約されています。 format: int32 pageName: type: string description: この行が含まれるスプレッドシートのシート／ページの名前。 rowData: type: array items: type: string ErrorDetail: required: - message type: object properties: code: type: string description: エラーの詳細に関連付けられているステータスコード context: type: object additionalProperties: type: array items: type: string description: エラー条件に関する背景状況 example: '{missingScopes=[scope1, scope2]}' in: type: string description: エラーが見つかったフィールドまたはパラメーターの名前。 message: type: string description: エラーと修正手順（該当する場合）を記した、人が理解できるメッセージ subCategory: type: string description: エラーに関する具体的な詳細が含まれる特定のカテゴリー responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://app.hubspot.com/oauth/authorize tokenUrl: https://api.hubapi.com/oauth/v1/token scopes: crm.import: '' ````