For the complete documentation index, see llms.txt.

POST /v1/hubspot/import-all

Start Bulk Import

Start a bulk import job to import all HubSpot contacts. Returns immediately with a job ID. Use GET /import-jobs/{jobId} to check progress.

Auth required: Yes

Parameters

• Idempotency-Key (header, string) — Unique key for idempotent POST requests (1-256 chars: alphanumeric, `_`, `-`, `:`, `.`). Same key + same body within 24h replays the cached response.

Request Body

• relationship_type: string — Default relationship type for imported contacts
• send_emails: boolean — Whether to send invitation emails

Responses

• 202: Import job started
• 400: Bad request
• 401: Authentication required or invalid
• 409: A request with this Idempotency-Key is currently being processed
• 422: Idempotency-Key was already used with a different request body

Authentication

Requires authentication. Pass a Bearer token (Supabase JWT) or an API key (`Authorization: Bearer vennio_sk_live_*`) in the request headers.

Base URL: https://api.vennio.app