---
title: "Start Linkedin Connections"
method: POST
path: "/api/linkedin/connections/start"
tags: ["linkedin-connections"]
---

# Start Linkedin Connections

`POST /api/linkedin/connections/start`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/linkedin/connections/start`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

## Request body

- LinkedInConnectionsStartRequest
  - `contract_version` 'linkedin-connections.v1', required
  - `sender_account_id` string, required

## Response `202`

Successful Response

- LinkedInConnectionsStartResponse
  - `accepted_pricing` AcceptedJobPricing, required: Immutable rule used to rate this job; final usage determines the actual charge.
    - `basis` 'none' | 'successful_execution' | 'successful_provider_attempt' | 'requested_record' | 'delivered_record' | 'successful_record' | 'provider_unit' | 'provider_cost_usd' | 'resolver_reported', required
    - `billing_owner` 'none' | 'growth_capability' | 'source_execution' | 'enrichment_reservation', required
    - `credits_per_unit` string, required: Exact Decimal customer-credit rate per unit, encoded as a string. This is not the final charge.
    - `pricing_version` string, required: Immutable published rate-book revision captured when the job was admitted.
    - `unit` string, required: Unit counted by basis, such as a record or execution.
  - `artifact_id` string, required: Immutable artifact identity containing committed result rows.
  - `execution_contract_digest` string, required: SHA-256 digest of the execution contract.
  - `execution_id` string, required: Capability-accounting execution identity for this admission.
  - `failed` boolean
  - `finished` boolean
  - `generation_id` string, required: Immutable output-generation identity.
  - `job_id` string, required: Stable durable job handle used for waiting, recovery, and diagnostics.
  - `operation_key` string, required: Stable logical operation identity.
  - `phase` string
  - `progress_current` integer
  - `progress_total` integer
  - `request_digest` string, required: SHA-256 digest of the canonical request.
  - `result_kind` 'linkedin_connections'
  - `rows` LinkedInConnectionRow[]: Bounded committed-row preview; never the complete artifact.
    - `first_name` string, nullable, required: Observed first name when the provider supplies it.
    - `full_name` string, nullable, required: Observed display name for the connection.
    - `headline` string, nullable, required: Observed LinkedIn headline.
    - `inventory_generation_id` string, required: Immutable inventory generation that supplied the row.
    - `last_name` string, nullable, required: Observed last name when the provider supplies it.
    - `linkedin_url` string, nullable, required: Canonical public LinkedIn person URL when observed.
    - `location` string, nullable, required: Observed profile location.
    - `profile_picture_url` string, nullable, required: Observed public profile-image URL when available.
    - `provider_member_id` string, required: Stable provider member id for dedupe within this account.
    - `public_identifier` string, nullable, required: Public LinkedIn profile slug when observed.
    - `relation_created_at` string, nullable, required: Provider relation timestamp when available.
    - `sender_account_id` string, required: Connected sender account that owns this inventory.
    - `source` 'linkedin_connection_inventory', required: Canonical provenance label for connection-inventory rows.
    - `title` string, nullable, required: Alias of headline in the connection inventory; not independently verified current-role evidence.
  - `semantic_fingerprint` string, required: SHA-256 digest of semantic inputs and immutable dependencies.
  - `source_digest` string, nullable
  - `status` 'queued' | 'running' | 'blocked' | 'completed' | 'failed'
  - `summary` LinkedInConnectionsJobSummary, required: Known Job.summary admission and terminal fields plus safe progress extensions.
    - `accepted_pricing` AcceptedJobPricing: Immutable rule used to rate this job; final usage determines the actual charge.
      - `basis` 'none' | 'successful_execution' | 'successful_provider_attempt' | 'requested_record' | 'delivered_record' | 'successful_record' | 'provider_unit' | 'provider_cost_usd' | 'resolver_reported', required
      - `billing_owner` 'none' | 'growth_capability' | 'source_execution' | 'enrichment_reservation', required
      - `credits_per_unit` string, required: Exact Decimal customer-credit rate per unit, encoded as a string. This is not the final charge.
      - `pricing_version` string, required: Immutable published rate-book revision captured when the job was admitted.
      - `unit` string, required: Unit counted by basis, such as a record or execution.
    - `artifact_id` string: Durable artifact containing normalized connection rows.
    - `baseline_completeness_kind` 'cursor_exhausted': Completeness proven for the immutable baseline inventory.
    - `baseline_connection_count` integer: Rows proven by the cursor-exhausted baseline generation.
    - `baseline_cursor_exhausted` true: True only when the baseline provider cursor was exhausted.
    - `capability_id` 'linkedin.connections.read': Canonical billed capability identity.
    - `committed_page_count` integer: Cursor pages durably committed before materialization.
    - `completeness` 'complete': Proven terminal completeness state.
    - `connection_count` integer: Baseline rows plus later observed additions in the materialized result.
    - `execution_contract_digest` string: Digest of reviewed execution semantics.
    - `generation_id` string: Immutable semantic output-generation identity.
    - `inventory_generation_id` string: Immutable inventory generation adopted by this terminal result.
    - `manifest_digest` string: SHA-256 digest of the immutable inventory manifest.
    - `membership_semantics` 'cursor_exhausted_baseline_plus_observed_additions': Exact membership interpretation for baseline and additive observations.
    - `operation_key` string: Stable logical operation identity.
    - `physical_attempt_count` integer: Physical LinkedIn provider attempts used to build the adopted generation.
    - `removals_proven` false: False because absence after the baseline is not proof of removal.
    - `result_kind` 'linkedin_connections': Typed terminal-result discriminator.
    - `result_manifest_digest` string: Digest of the exact terminal result manifest.
    - `semantic_fingerprint` string: Digest of semantic inputs and immutable dependencies.
    - `tool_kind` 'linkedin_connections': Artifact-job implementation kind.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)