---
title: "Start Crm Upsert To List"
method: POST
path: "/api/crm/objects/upsert-to-list/start"
tags: ["growth-artifact-jobs"]
---

# Start Crm Upsert To List

`POST /api/crm/objects/upsert-to-list/start`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/crm/objects/upsert-to-list/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

- StartCrmUpsertToListRequest
  - `account_behavior` 'require_company' | 'ignore'
  - `artifact_label` string, nullable
  - `id_property` string, nullable
  - `idempotency_key` string, required
  - `list_id` string, nullable
  - `object_type` 'contacts' | 'companies', required
  - `owner_policy` 'preserve_active' | 'allow_override'
  - `preflight_only` boolean
  - `provider` 'hubspot'
  - `provider_account_id` string, required
  - `records` union[], required
    - union
      - CrmUpsertRecordRequest
        - `id` string, required
        - `properties` object
      - CrmResolvedUpsertRecordRequest
        - `expected_provider_record_id` string, nullable
        - `identifiers` CrmIdentityIdentifierRequest[], required
          - `kind` 'email' | 'domain' | 'linkedin_url', required
          - `property` string, required
          - `value` string, required
        - `identity_expectation` 'any' | 'new' | 'existing'
        - `intended_company_provider_id` string, nullable
        - `properties` object
        - `source_key` string, required

## Response `200`

Successful Response

- StartCrmUpsertToListResponse
  - `artifact_id` string, required
  - `execution_id` string, nullable
  - `job_id` string, required
  - `object_type` 'contacts' | 'companies', required
  - `provider` 'hubspot', required
  - `record_count` integer, required
  - `status` string, required
  - `workflow_run_id` string, required

## 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)