Set Salesforce Connector profile configurations

Learn how to create or update a Salesforce Connector profile configuration for a tenant.

This operation creates or updates a Salesforce Connector profile configuration for the specified tenant. If a profile with the given name exists, it is replaced. The ReltioSQS field from the existing configuration is preserved. If the profile does not exist, a new profile is created and the ReltioSQS field is derived from the connector configuration.

HTTP method and endpoint

POST {SalesforceConnectorURL}/configuration/{tenantId}/{profileName}

Endpoint path parameters


Parameter	Type	Required	Description
`tenantId`	String	Yes	Unique identifier of the tenant.
`profileName`	String	Yes	Name of the Salesforce Connector profile.

Query parameters


Parameter	Type	Required	Description	Accepted values / Default
`generateDefaultMapping`	Boolean	No	Generates default mapping for new profiles. Only processed when creating a new profile. Requires a `Salesforce` source in the tenant configuration.	True or False. Default: false

Request headers


Header	Required	Description
`Authorization`	Yes	Bearer token for authentication (for example, `Bearer <accessToken>`).
`Content-Type`	Yes	Must be `application/json`.

Request body


Parameter	Type	Required	Description	Accepted values / Default
`reltio.skipUnchangedAttributes`	Boolean	No	Syncs only changed values. Prevents timestamp updates when values remain unchanged.	True or False. Default: false
`reltio.skipNestedAttributesOnFieldNull`	Boolean	No	Excludes computed or hardcoded expressions (for example, `Type` or `Identifier`), when all Salesforce object fields ( `sObject`) present in the nested attribute mapping resolve to null. Prevents creation of nested attributes with `null` primary values.	True or False. Default: false

The following example shows a complete request body:

{
  "salesforce": {
    "loginUrl": "<sfdcLoginUrl>",
    "user": "<sfdcServiceUser>",
    "password": "<sfdcServicePassword>"
  },
  "reltio": {
    "tenantUrl": "<tenantApiUrl>",
    "authUrl": "<authUrl>",
    "skipUnchangedAttributes": true,
    "skipNestedAttributesOnFieldNull": true,
    "workflowUrl": "<workflowUrl>",
    "username": "<reltioServiceUser>",
    "password": "<reltioServicePassword>",
    "maxObjectsToUpdateZero": true,
    "mergeCheck": false,
    "authToken": "<base64token>",
    "batchSize": 50,
    "maxapicall": 300,
    "mergeMoveToWinner": true
  }
}

Response

Success: HTTP 200

{profileName} has been updated

Error: HTTP 400

{
  "error": {
    "reason": "<error description>"
  }
}

Behavioral notes

The skipNestedAttributesOnFieldNull parameter applies only to nested attribute mappings in the Salesforce-to-Reltio direction.
This parameter does not modify entity-level filtering behavior.
This parameter does not change the behavior of skipUnchangedAttributes.
When set to false, legacy behavior is preserved and computed expressions may create nested attributes even when source fields are null.

Unify and manage your data