---
title: "Salesforce Core configuration guide"
canonical: "https://ingrid-support.refined.site/space/KB/410288133/Salesforce%20Core%20configuration%20guide"
format: markdown
---
The Salesforce Core configuration guide explains how to connect your Salesforce Commerce store to Ingrid Returns using OAuth-based API integration, enabling automated order lookup, return processing, and refund creation.

---

### Onboarding Requirements

- Salesforce Core account
- OCAPI and Core API credentials
- Web-hook configuration access

---

### **Setup Steps**

1. In Returns Back-office: **Settings → Integrations → Ecom Integration → Add New**
2. Select **Salesforce Core** from dropdown
3. Enter the required credentials:
  1. API URL, Cloud Commerce client ID & secret
  2. OCAPI URL, Short code, Organisation ID
  3. Core client ID & secret
  4. Public URL, Salesforce web-hook URL & secret
4. Optionally enable **Create returns from warehouse notifications**
5. Click **SAVE**

---

### **Available Salesforce Core Settings**

| **Setting** | **Description** | **Required** |
| --- | --- | --- |
| API URL | Salesforce Commerce API endpoint | Yes |
| Cloud Commerce client ID | OAuth client ID for Cloud Commerce | Yes |
| Cloud Commerce client secret | OAuth client secret for Cloud Commerce | Yes |
| OCAPI URL | Open Commerce API endpoint | Yes |
| Short code | Salesforce site short code | Yes |
| Organization ID | Salesforce organisation identifier | Yes |
| Core client ID | OAuth client ID for Salesforce Core | Yes |
| Core client secret | OAuth client secret for Salesforce Core | Yes |
| Public URL | Public-facing storefront URL | Yes |
| Salesforce web-hook URL | URL for receiving Salesforce web-hook events | Yes |
| Salesforce web-hook secret | Secret for validating web-hook payloads | Yes |
| Create returns from warehouse notifications | Checkbox. When enabled, Ingrid automatically creates return cases based on warehouse notifications. | No |

![image](media://346554e6-964f-4bc6-a33d-b8a266f68b9e)