---
title: "PUT /api/integrations/crm/settings"
method: PUT
path: "/api/integrations/crm/settings"
tags: ["crm"]
---

# PUT /api/integrations/crm/settings

`PUT /api/integrations/crm/settings`

## Request

- Base URL: `https://app.heykairon.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.heykairon.com/api/integrations/crm/settings`
- Auth: API key in header `x-api-key`

## Request body

- CrmSettingsDto
  - `triggerStage` 'invite_sent' | 'connected' | 'contacted' | 'replied' | 'interested' | 'meeting_booked' | 'won', required
  - `mapping` object[], required
    - `from` 'first_name' | 'last_name' | 'full_name' | 'headline' | 'summary' | 'location' | 'linkedin_url' | 'email' | 'stage' | 'tags' | 'qualification.status' | 'current_company.name' | 'current_company.domain' | 'current_company.linkedin_url' | 'current_company.industry' | 'current_company.employee_count' | 'current_company.location' | 'fixed_value', required
    - `to` string, required
    - `defaultValue` string, required
    - `overwrite` boolean, required
    - `optional` boolean, required
  - `leadMapping` object[]
    - `from` 'first_name' | 'last_name' | 'full_name' | 'headline' | 'summary' | 'location' | 'linkedin_url' | 'email' | 'stage' | 'tags' | 'qualification.status' | 'current_company.name' | 'current_company.domain' | 'current_company.linkedin_url' | 'current_company.industry' | 'current_company.employee_count' | 'current_company.location' | 'fixed_value', required
    - `to` string, required
    - `defaultValue` string, required
    - `overwrite` boolean, required
    - `optional` boolean, required
  - `pushMode` 'salesforce_lead' | 'contact'
  - `convertLeads` boolean
  - `source` object
    - `property` string, required
    - `value` string, required

## Response `200`

## Changes

- **2026-10-20** `9300d7582735`: 2 info
  - added the new `fixed_value` enum value to the request property `leadMapping/items/from`
  - added the new `fixed_value` enum value to the request property `mapping/items/from`

[Operation history](https://skmtc.dev/heykairon/apis/kairon-api/changes/api/integrations/crm/settings/put.md)

---

[API](https://skmtc.dev/heykairon/apis/kairon-api.md) · [All operations](https://skmtc.dev/heykairon/apis/kairon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heykairon/apis/kairon-api/revisions/35de550d5938?raw)