Unify and manage your data

Set Salesforce Connector Profile Configurations

Learn about setting profile configurations for the specified tenant

This operation sets Salesforce connector profile configurations for the specified tenant. The Request body in the JSON format defines a new configuration with a name. If a configuration with this name exists, it is replaced, and ReltioSQS field from the old profile configuration is added to the new profile configuration. If the profile configuration with the specified name does not exist, a new profile is created, and ReltioSQS field is provided from the connector configuration. It contains the sqsTemplate field, which contains a template as follows:

"sqsTemplate": {
  "reltioSQS": {
    "awsOwner": "<owner>",
    "queue": "<queue name>"
  }
}

Request

Operation Endpoint:

POST {Salesforce connector URL}\configuration\{tenantId}\{profileName}
Table 1. Parameters
ParameterRequiredDescription
HeadersAuthorizationYesAccess token in the format Bearer <accessToken> (see Authentication API)
Content-TypeYesMust be application/json
QuerytenantIdYesTenant ID
QueryprofileNameYesName of the profile
QuerygenerateDefaultMappingNoMust be the default mapping generated. Possible values: true and false.

Default: false. Only processed for new profiles. Requires Salesforce source in tenant config.

BodyYes
{
  "salesforce": {
    "loginUrl": "<sfdcLoginUrl>",
    "user": "<sfdcServiceUser>",
    "password": "<sfdcServicePassword>"
  },
  "reltio": {
    "tenantUrl": "<tenanApiUrl>",
    "authUrl": "<authUrl>",
    "skipUnchangedAttributes": true,
    "workflowUrl": "<workflowUrl>",
    "username": "<reltiServiceUser>",
    "password": "<reltiService>",
    "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>"
      }
    }

Profile configuration fields

salesforce

  • namespace – Salesforce package namespace.
  • loginUrl – Salesforce login URL.
  • user – Salesforce service user.
  • password – Salesforce user's password.
  • pollTime – Polling interval in seconds. Default: 300.
  • checkFieldsChanged – Enables field-based event triggering. Requires resync via Control Panel.

reltio

  • tenantUrl – Tenant URL.
  • authUrl – Authorization URL.
  • username – Reltio service user.
  • password – Reltio password.
  • authToken – Base64 encoded token.
  • batchSize – Number of entities per batch. Default: 50.
  • maxapicall – Max API calls per minute. Default: 300.
  • mergeMoveToWinner – Moves reference data from loser to winner contributor before setting delete date.
  • deltaFiltering – Filters events based on data delta.
  • skipUnchangedAttributes – Syncs only changed values; prevents timestamp update unless values change.

reporting

  • email – Notification email.
  • reportConnection – Alerts for connection failures. Default: false.
  • logSyncErrors – Enables logging of sync issues.

processor

  • enabled – Enables large object handling. Default: false.
  • crosswalkNumber – Threshold of crosswalks for large object. Default: 200.
  • attributeNumber – Threshold of attributes. Default: 200.
  • attributeValueNumber – Threshold of values per attribute. Default: 200.
  • attributeValueSize – Max attribute value length (in bytes). Default: 10240.