> For the complete documentation index, see [llms.txt](https://docs-vnext.kiflo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-vnext.kiflo.com/integrations/salesforce/how-to-map-deal-stages-with-salesforce.md).

# How to map deal stages with Salesforce?

When the Salesforce integration is turned on, deals in Kiflo are synced with opportunities in Salesforce.

Every time a deal moves to a new stage in Salesforce or in Kiflo, the corresponding deal will move to the mapped stage on the other side.

This article describes how deal stages can be mapped.

{% hint style="info" %}
**Before you begin**

* Make sure the Salesforce integration is enabled: [Salesforce](/integrations/salesforce/salesforce.md)
* And you turned on the right settings to sync deals: [Settings](/integrations/hubspot/hubspot.md#turn-on-settings)
  {% endhint %}

To configure deal stages mapping:

* Go to the **Manage** pas
* Click on **Integrations**
* Click on **Salesforce**
* Click on the tab **Mapping**
* Then select **Deals**
* And click on the **Stage** field:

![](https://3041514930-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkJn82Qo5a0Y4fOsoQzo%2Fuploads%2Fgit-blob-95344b3e325fe406a0c3af68047ecbf1510a8dd1%2F663394f25ae8353469c6b28d.png?alt=media)

{% hint style="info" %}
**Not seeing the Stage field in the list?**

Kiflo automatically maps stages when the integration is turned on. If you don't see the "Stage" field in the list, it must have been deleted.

Click the "Add mapping" button and search for "stage" to create a new mapping.
{% endhint %}

## Map deal stage

Every deal stage in Kiflo must be mapped to another deal stage in Salesforce. And vice-versa.

If you do not have the same number of stages in Kiflo and Salesforce, you can map the same stage multiple times.

### Edit mapping

On the left columns are all the stages in Kiflo. On the right column are all the stages in Salesforce.

Below, the stage *Qualification* in Kiflo is mapped with the stage *News Analysis* in Salesforce:

![](https://3041514930-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkJn82Qo5a0Y4fOsoQzo%2Fuploads%2Fgit-blob-e4a3f707fed6d366bb2040383aeffd1aed19c2f0%2F66339693e66450147a8e61e5.png?alt=media)

In the example below, there are more stages in Salesforce. The stages *Qualification* and *Contract Sent* from Kiflo are mapped to many different stages in Salesforce:

![](https://3041514930-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkJn82Qo5a0Y4fOsoQzo%2Fuploads%2Fgit-blob-6dd9734957c0adc27e44b2d35ae9e714552b5876%2F663399f05ae8353469c6b294.png?alt=media)

### Common errors

When saving the mapping, you may see the following error:

![](https://3041514930-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkJn82Qo5a0Y4fOsoQzo%2Fuploads%2Fgit-blob-cd822a92c55b8491aca5879381b256ae725b630f%2F663399787303ea4a739d3d20.png?alt=media)

It indicates one or more stages are not defined in the mapping.

In the example above, there is a stage named "Opened" in Salesforce that is not mapped with any stage in Kiflo.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs-vnext.kiflo.com/integrations/salesforce/how-to-map-deal-stages-with-salesforce.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.