> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.metalocator.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Importing Data from Salesforce

Import location records from Salesforce into MetaLocator using the Salesforce connector. You can run a single import or, if your account includes background importing, keep your location data updated on a schedule.

The connector reads Salesforce data and imports it into MetaLocator. It does not write any changes back to Salesforce.

## Before you begin

You will need:

* A MetaLocator account with permission to import data.
* A Salesforce administrator to create an External Client App.
* A Salesforce user with API access and permission to read the records and fields you want to import. This user must be able to complete Salesforce’s browser sign-in.
* The name of the Salesforce object containing your data, such as **Account**, and the fields containing each location’s name and address.

For recurring imports, use a Salesforce user whose access will remain available for the integration. Your Salesforce administrator should confirm the app’s user-access and refresh-token policies.

This guide uses Account records and their shipping addresses as an example. Use the object and address fields that represent your actual locations.

## Step 1 Create the Salesforce app

Have your Salesforce administrator complete these steps in the Salesforce organization you want to import from.

1. Open **Setup** and search for **External Client App Manager** in Quick Find.
2. Open **External Client App Manager** and select **New External Client App**. Depending on your Salesforce layout, this button may also appear in **App Manager**.
3. Enter an app name, such as **MetaLocator Salesforce Import**, and a contact email. Complete any other required basic fields.
4. Enable **OAuth** in the app’s OAuth settings.
5. Enter this **Callback URL** for the standard MetaLocator admin environment:

```
https://admin.metalocator.com/salesforceoauthcallback
```

The URL must match exactly, with no trailing slash.

1. Add both OAuth scopes:

* **Manage user data via APIs (api)**
* **Perform requests at any time (refresh_token, offline_access)**
2. If Salesforce displays flow settings, enable the **Web Server** or **Authorization Code** flow. Keep **Require Secret for Web Server Flow** enabled. MetaLocator supports **PKCE**, so you can keep it enabled if required by your organization.
3. Create or save the app.
4. Open the app’s **Settings → OAuth Settings → Consumer Key and Secret**. Complete Salesforce’s identity verification if prompted, then copy the **Consumer Key** and **Consumer Secret** for the next step. Keep the secret private.
5. Check the app’s **Policies**. If access is restricted to administrator-approved users, authorize the Salesforce user who will connect MetaLocator through the appropriate profile or permission set.

MetaLocator uses browser authorization and a refresh token for this connection. You do not need to configure the Client Credentials flow or supply a Salesforce password, security token, or WSDL file to MetaLocator.

For Salesforce’s app-management screens, see [Create an External Client App](https://developer.salesforce.com/docs/platform/sfdx-dev/guide/sfdx-dev-auth-eca.html). Use the MetaLocator callback URL and two scopes above; that Salesforce reference also describes settings for other integrations.

## Step 2 Prepare an External Key in MetaLocator (Optional)

Use the Salesforce record’s `Id` column to identify the same location on future imports. This may be AccountId, Id, ContactId or similar unique identifier. This is especially helpful when creating a recurring import job. See [External Key Fields](https://support.metalocator.com/en/articles/1655677-external-key-fields) for import information.

1. In MetaLocator, open **Locations → Fields**.
2. Select **New**.
3. Name the field **Salesforce ID**.
4. Choose **External Key** as the **Field Type** and save.

Only one External Key field can exist per table. If your location table already has one, use the existing key strategy instead of creating another field. See [External Key Fields](https://support.metalocator.com/en/articles/1655677-external-key-fields).  
​

## Step 3 Connect MetaLocator to Salesforce

1. Open **Locations → Import**.
2. Choose **Salesforce** as the data source and continue to the connection screen.
3. Set **Connector Mode** to **REST**.
4. Fill in the connection settings:

| MetaLocator setting | What to enter |
| --- | --- |
| Connected App Client ID | The External Client App’s Consumer Key |
| Connected App Client Secret | The External Client App’s Consumer Secret |
| SalesForce Environment | Production for your live organization, or Sandbox for a test organization |
| SalesForce API Version | Keep the prefilled value unless your Salesforce administrator or MetaLocator Support specifies another supported version. The format is vNN.N, such as v59.0. |

The fields are labeled “Connected App” in MetaLocator, but they also accept your External Client App credentials.

1. Click **Connect to Salesforce**.
2. On Salesforce’s sign-in page, sign in as the user authorized for the integration. Complete any required authentication and approve access if prompted.
3. After returning to MetaLocator, confirm that **Connection Status** shows **Connected to:** followed by your Salesforce instance.
4. Click **Test Connection** and confirm that it succeeds before selecting data.

## Step 4 Choose the records and fields to import

### Option 1: Use the Field Chooser

1. Open **Field Chooser**.
2. Choose **Account** from **Object**, or select the object containing your locations.
3. Choose a field from **Field**, then click **Add**.
4. Repeat until **Selected Fields** contains everything you need.

For the Account example, include:

* `Id`
* `Name`
* `ShippingStreet`
* `ShippingCity`
* `ShippingState`
* `ShippingPostalCode`
* `ShippingCountry`

You can also include fields such as `Phone` and `Website`. Salesforce may display friendly field labels instead of these API names.

The Field Chooser selects fields from one object. If you need to filter which records are imported, use a custom query.

### Option 2: Use a Custom Query when you need a filter

Open **Custom Query** and enter a Salesforce SOQL query.

This example selects Accounts with a shipping street address:

```
SELECT Id, Name, ShippingStreet, ShippingCity, ShippingState,ShippingPostalCode, ShippingCountry, Phone, Website FROM Account WHERE ShippingStreet != null
```

Click **Test** and review **Results Preview**. The preview shows up to five rows; it is not the full import. Confirm that the records represent the locations you want to publish. Ask your Salesforce administrator to adapt the query if you use custom objects, custom fields, or an eligibility field such as an active-location flag.  
​

Use either a custom query or the Field Chooser. Clear an existing custom query before returning to the Field Chooser.  
​

## Step 5 Choose whether to keep the data updated

For a recurring import, select **Keep SalesForce Data In Sync?** before continuing. This option requires access to background importing and creates a job using the mapping and import options you complete next.  
​

Leave it unchecked for a one-time import. Click **Next** and wait for MetaLocator to retrieve the Salesforce data.  
​

## Step 6 Match your Salesforce fields to MetaLocator

On **Match Columns**, check every destination field. For the Account example, use these mappings:

| Salesforce field | MetaLocator destination |
| --- | --- |
| Id | Salesforce ID, the External Key field created earlier |
| Name | Name |
| ShippingStreet | Address |
| ShippingCity | City |
| ShippingState | State |
| ShippingPostalCode | Postal Code |
| ShippingCountry | Country |
| Phone | Phone |
| Website | Website |

Map the Salesforce `Id` to your External Key field, not MetaLocator’s own `ID` field.

Map address values to the system address fields. Unmatched columns may become custom fields, which will not serve as the location’s physical address. Continue after checking the mapping.  
​

## Step 7 Choose import options and verify the results

1. For imports that will be repeated, select **Update Existing & Insert New**. With an External Key, MetaLocator can update an existing Salesforce location and add new locations.
2. Leave **Delete Unmatched Records (Sync)** off for the initial setup. Enable it only if you intend to remove MetaLocator records missing from the Salesforce result and have configured the appropriate scope.
3. Continue to run the import.
4. Review **Import Summary** for errors. Complete geocoding if prompted.
5. Open the imported locations and check their names, addresses, External Keys, and map positions.

**Add** can create duplicates on repeat runs when external keys are not present. **Replace** deletes existing destination data before importing. See [Introduction to importing data](https://support.metalocator.com/en/articles/1655854-introduction-to-importing-data) for all import options.  
​

## Step 8 Enable scheduled imports

If you selected **Keep SalesForce Data In Sync?**:

1. Open **Background Jobs** using the processes icon in the upper-right toolbar.
2. Find the new Salesforce import job. New jobs are initially unpublished.
3. Select the job and click **Force** to test a background run.
4. Check the result and confirm that existing locations were updated without duplication.
5. Turn **Scheduled** on when the job is ready.

The default interval is every 24 hours. Contact MetaLocator Support if you need a different schedule. See [Background Importing](https://support.metalocator.com/en/articles/4343052-background-importing).  
​

Changes you later make to the selected columns also require updating the job’s saved mapping through **Edit Import Settings**. If you reconnect Salesforce, re-save the affected scheduled import so it uses the new connection.

## Salesforce SOQL Queries

MetaLocator can import fields from a single object at a time using the Field Chooser. To create more complex queries, including those with joins from multiple tables, you must [author SOQL](https://developer.salesforce.com/docs/atlas.en-us.soql_sosl.meta/soql_sosl/sforce_api_calls_soql.htm) and add it to the Custom Query tab. The query must return the columns directly in the result, or as within a single relation.

An example SOQL query is provided below:

```
SELECT Name,ShippingStreet, ShippingCity, ShippingState, ShippingPostalCode FROM Account
```

This simple SOQL example pulls 5 columns from the Account object. Users commonly include filters in "WHERE" clauses to limit the data, such as in the following example which uses a custom field called "Account_Status":  
​

```
SELECT Name,ShippingStreet, ShippingCity, ShippingState, ShippingPostalCode FROM Account WHERE Account_Status__c = 'Active'
```

## Salesforce Relations and Relationship Fields

MetaLocator's data importer consumes 2-dimensional data, however; SOQL can produce multi-dimensional data sets, where a single column referenced in the query returns multiple rows as in a one-to-many relationship. In this case, the data is returned with each row in the the "one" side of the relationship repeated for every related row in the relation.

For example:

```
SELECT Account.Name, Id, (SELECT Contact.LastName FROM Account.Contacts) FROM Account
```

In this example, the related Contacts object includes multiple contacts for each Account. This causes the Account rows to repeat.

[![](https://storage.crisp.chat/users/helpdesk/website/-/3/4/5/a/345a1635aeb32000/825dd312-021e-4751-9951-6df0f2_17z57qg.png)](https://downloads.intercomcdn.com/i/o/yn1vvwtq/2709456717/208a8492ed11bf600e7597885949/image.png?expires=1794511800&signature=3ef6d6c6025bfd1e1c8b7ee841eae9afc7f2b1dd8a2abafe5bc3819d32fe9af2&req=dicnH817m4ZeXvMW1HO4zfGzHauTbg%2B1WJ3RsTggdm6JXdYmjXw5XjmWk83v%0AYc6m0oytCFVv1hf781k%3D%0A)

Relationship fields will be appended to end of the data set. The following query will produce the same response as the example above.

```
SELECT (SELECT Contact.LastName FROM Account.Contacts), Account.Name, Id FROM Account
```

For very complex transformations involving multiple tables and filters, SOQL may be too limited. In these cases, some customers have used tools like dataloader.io to instead create a CSV from Salesforce and then used our SFTP or CSV Import instead of connecting MetaLocator directly to Salesforce.  
​

## Troubleshooting

### The connection says Not connected

Enter the app’s Client ID and Client Secret, select the correct environment, and click **Connect to Salesforce**. Complete the browser sign-in before using **Test Connection**.  
​

### Salesforce reports a callback or redirect URL mismatch

Check the app’s Callback URL character for character. For the standard MetaLocator admin environment it is `https://admin.metalocator.com/salesforceoauthcallback`, with no trailing slash. Dedicated environments must use their configured callback URL.

### Salesforce did not return a refresh token

Add **Perform requests at any time (refresh_token, offline_access)** to the app’s OAuth scopes, save the change, and reconnect from MetaLocator.

### Sign-in is blocked or a field is missing

Ask your Salesforce administrator to check API access, the app’s permitted-user policy, record sharing, and read access to the selected objects and fields. Confirm that you chose the intended Production or Sandbox environment.

### A scheduled import reports an expired or invalid token

Reconnect with **Connect to Salesforce**, then re-save the affected scheduled import. Ask your Salesforce administrator to review token expiration or revocation policies if the problem returns.

### The query returns no records or an error

Confirm that the object and field API names are correct and that the connected user can read the records. Review any `WHERE` filter with your Salesforce administrator, then use **Test** again.

### Repeat imports create duplicate locations

Check that Salesforce `Id` is mapped to the External Key field and that the job uses **Update Existing & Insert New**. Verify that existing records have the same External Key values.

### Background importing is unavailable

The sync checkbox is shown only to accounts with the required access. Contact MetaLocator Support to confirm availability for your account.

When contacting support, include the job name, selected environment, exact error message, and the time of the failed run. Do not include your Client Secret or authentication tokens.

## Legacy SOAP Connections

MetaLocator supports using the SalesForce SOAP API to import data and will continue support through summer of 2027.

The below steps are for the legacy SOAP connector. Any new integrations should use the new REST connector described above

You can import location data directly from your Salesforce Account into MetaLocator.  To import your data, click Data, then Import.  Choose the Salesforce icon as your Data Source:

[![](https://storage.crisp.chat/users/helpdesk/website/-/7/c/6/a/7c6aa1559c80c800/db5c72eb-d8dd-427d-a278-f998f3_l6wryh.png)](https://downloads.intercomcdn.com/i/o/71450297/afe17bce756d1385fb1179fa/image.png?expires=1794511800&signature=3681296eefd5e48d744108279289bddf62b66c518224e6c6890c3e7671d65929&req=cyEjE8l8lIYTWLcX3D%2B5hmDf6rLJN0zTo7y9pBDNmHvFy3TgY%2FlaCxs4fRca%0AtuBadYiX4RxdeZOo%0A)

Click next to show the Salesforce Connection information.  Here you must provide your Salesforce credentials to connect your account.  
​

[![](https://storage.crisp.chat/users/helpdesk/website/-/d/a/7/5/da75ad859b4e0800/647f47c8-954d-485c-b31a-348885_1r6aehk.png)](https://downloads.intercomcdn.com/i/o/71450403/a215b5c7924e6d0d560601fe/image.png?expires=1794511800&signature=310576f9d2947132f92bf3c0bcc1fe703d7681f8987040fc87d36b413a1b458f&req=cyEjE8l6nYITWLcX3D%2B5huCSVUIkgmeTlehrm6XQxP08SWkfbNERkhiiEnQk%0AgHnzU0aUyI4QHNIy%0A)

Once you provide a username, password and [security token](https://success.salesforce.com/answers?id=90630000000glADAAY), click **Sign In**. This will load the Salesforce Objects available to your account in the Object drop-down box. To choose fields to import, choose the Salesforce object first from the Object drop-down box.  That will load the list of Salesforce Fields available from that object in the Fields drop-down box.  Choose a desired field and click **Add** to add it to the Selected Fields.  Continue adding fields as needed.

You may encounter connection issues if your password contains XML-reserved characters such as

```
<   
>  
&  
"  
'

```

## Sandbox Accounts

Those requiring access to a Salesforce Sandbox Account must provide the Sandbox [Partner WSDL](https://developer.salesforce.com/docs/atlas.en-us.api.meta/api/sforce_api_partner.htm) from their SFDC account.  Click the Upload WSDL file button which appears after choosing Sandbox from the Salesforce Environment drop-down as shown below:

[![](https://storage.crisp.chat/users/helpdesk/website/-/a/5/3/e/a53e21c035b9f800/3ad68d1a-ed8b-47d3-a9c5-2c6c56_7y9w0o.png)](https://downloads.intercomcdn.com/i/o/878701556/23f3ba8a88b02d3a3d174008/image.png?expires=1794511800&signature=e51da01fb3c9a7cc65838d3b80a62fac5e46b0c38f4d7ad417bb3ce0f08ccede&req=fCcvEcl%2FmIRZFb4f3HP0gAR8rhdhaEx0%2FOpuygOkm6Py%2F4cqUnNShP1Mlxmc%0Alg6ifOBx4OsqqOP1jA%3D%3D%0A)

Similarly, if a specific version of Salesforce is required for items like compound objects contact the helpdesk to have a custom version of the Partner WSDL configured in your account.

Be sure to include basic location information for your records and a field for the name.  The data you choose to import should include at a minimum, Name (E.g. location name), Street Address City, State and Postal code.

## Mapping Fields

Once you have either chosen fields or written a custom query, click **Next**, and the import process will continue as usual.  Be sure to appropriately [map your SalesForce columns to MetaLocator System columns](https://support.metalocator.com/en/articles/1655854-introduction-to-importing-data#match-columns) as provided during the next step in the import process.

## Modifying Salesforce Job and Import Mapping

Once a Salesforce import is running, you may want to modify the import rules, schedule, or query. The import is comprised of two elements, the Job and the Import Configuration.

**Modify the Job Fields:**

Note: updating the query will require a [re-run of the job](https://support.metalocator.com/en/articles/4343052-background-importing#h_ad8ba01f28) and new mappings to be applied. See the **Modify the Import and Mapping** blow for next steps.

[![](https://storage.crisp.chat/users/helpdesk/website/-/a/0/b/9/a0b9531b0a504800/69a119c9-80b3-4d65-8b07-8f1fec_1uffyms.png)](https://downloads.intercomcdn.com/i/o/227063211/4b8557e065ceceb2bc4b9a43/image.png?expires=1794511800&signature=6cd33a3de9bf437c8d3c879d3957f107c0be0dbeca70fd82d3931677461bda21&req=diIgFs99n4BeFb4f3HP0gFfOycVULIX33QUjp9kGBP8cxWZBffWG6ClUcgOG%0A%2F7mvMccNYCGuDjV0Jg%3D%3D%0A)

1. Click the processes icon as shown
2. Select the name of the job to edit the Job fields
3. From there you can update the Username, Password, Token, Execution Schedule, Salesforce Query
Save the edits by clicking Save in the upper right

[![](https://storage.crisp.chat/users/helpdesk/website/-/b/4/4/7/b44700db7661b800/c824ef3e-edfb-44a9-8844-0435c1_kthg56.png)](https://downloads.intercomcdn.com/i/o/227063565/8307be8b48a264f5325c3ef8/image.png?expires=1794511800&signature=7b0dbf87733d028a6069aee105ff26cae9b69a3dfd8201edb7f491e8e9cb792d&req=diIgFs99mIdaFb4f3HP0gCmVGgXL2dN6bp2ay4PT6gno377wDBl%2BsZqVK0%2BD%0AzX0%3D%0A)

**Modify the Import and Mapping:**

Anytime a new field is added column mapping for the job will need to be re-done. Import options can also be changed from this process (E.g. Update Existing & Insert New).

[![](https://storage.crisp.chat/users/helpdesk/website/-/5/4/5/8/5458a8a144db8c00/0f2cf607-a1f1-4c07-b90e-7466fa_1g6bovw.png)](https://downloads.intercomcdn.com/i/o/yn1vvwtq/1334565840/05f94c5ff31a649066d628ec17af/image.png?expires=1794511800&signature=c32559965945c3ee472cce5edea70b681ad2aa1af4aad19fa7421514580b9a8a&req=dSMkEsx4mIlbWfMW1HO4ze3aSlNc5VMGccV5i3gYV3%2B%2BkzeYQMUc28CDClOU%0AiTo8fh3GoUR5st%2F28Rg%3D%0A)

1. Navigate to the Jobs menu in the upper right
Select the Actions dropdown for the job

[![](https://downloads.intercomcdn.com/i/o/yn1vvwtq/1602171172/7b5782436cad12236568d1c5a25b/image.png?expires=1794511800&signature=82d85797adba77684b63d47d7f50df98ee5eed92920554ce49b3893ffd6c4b89&req=dSYnFMh5nIBYW%2FMW1HO4zXv%2FWjwSHswJo8MM%2BIhpMohWatFQSPNHl8TCqP4%2B%0A1H6R%0A)](https://downloads.intercomcdn.com/i/o/yn1vvwtq/1602171172/7b5782436cad12236568d1c5a25b/image.png?expires=1794511800&signature=82d85797adba77684b63d47d7f50df98ee5eed92920554ce49b3893ffd6c4b89&req=dSYnFMh5nIBYW%2FMW1HO4zXv%2FWjwSHswJo8MM%2BIhpMohWatFQSPNHl8TCqP4%2B%0A1H6R%0A)

3. Select Edit Import Settings
Update any import field mappings and select next to save the changes

[![](https://downloads.intercomcdn.com/i/o/yn1vvwtq/1334579488/a661dab587f30eaacc120630331d/image.png?expires=1794511800&signature=fd834b8c381126dc82de9e407ab791235a725f44985e31883da5309e8797c950&req=dSMkEsx5lIVXUfMW1HO4zfqfGnBrvk4cm6MDqp56xdKcw5TOIFHFyXIHbN6j%0AX3ca%0A)](https://downloads.intercomcdn.com/i/o/yn1vvwtq/1334579488/a661dab587f30eaacc120630331d/image.png?expires=1794511800&signature=fd834b8c381126dc82de9e407ab791235a725f44985e31883da5309e8797c950&req=dSMkEsx5lIVXUfMW1HO4zfqfGnBrvk4cm6MDqp56xdKcw5TOIFHFyXIHbN6j%0AX3ca%0A)

5. On the next screen update any import options such as Update Existing & Insert New
Select Finish to save the updates

[![](https://downloads.intercomcdn.com/i/o/yn1vvwtq/1334578506/5c3b0b580d1fe06249b97a38c86a/image.png?expires=1794511800&signature=277f8abe4424a0df68595324da9a10054ad3ee3b2cab9c306423314d0c3cee9b&req=dSMkEsx5lYRfX%2FMW1HO4zcvxxnNEmgIHeVhgoF4x9GIHt6gNN9ihAjSl%2Fdac%0A0Ems%0A)](https://downloads.intercomcdn.com/i/o/yn1vvwtq/1334578506/5c3b0b580d1fe06249b97a38c86a/image.png?expires=1794511800&signature=277f8abe4424a0df68595324da9a10054ad3ee3b2cab9c306423314d0c3cee9b&req=dSMkEsx5lYRfX%2FMW1HO4zcvxxnNEmgIHeVhgoF4x9GIHt6gNN9ihAjSl%2Fdac%0A0Ems%0A)

The job now has updated field mappings and options that it will use the next time it is scheduled to run.

## Invalid or Incomplete Country information

Add a setting to your Salesforce job called **clean_country_data** with a value of **1** to invoke a process which tries to complete TLD and country data where it is provided empty.

MetaLocator looks for empty country fields with a TLD value, and sets the country name based on our internal database of country names. It only does this when the country name is not populated.

Similarly, if a country is provided, and a TLD is not provided, we look up the TLD by country name. This process should be considered a fallback. Ideally, complete country and TLD data should come directly from Salesforce.

Add a setting to your Salesforce job called **correct_country_data** with a value of **1** to invoke a process which tries to complete TLD and country data. This option will _overwrite_ provided country data with MetaLocator's standard English country spelling. This can be used in the case of inconsistent data in the country field.

## Changing the WSDL Version of an existing Import

When connecting to the Salesforce API, MetaLocator users can choose which Salesforce API version the connection should use. The API version is determined by the WSDL selection.

Existing background jobs may have WSDL options already set. To update an existing Salesforce background import job to a different WSDL, go to the Background jobs in the upper right:

[![](https://downloads.intercomcdn.com/i/o/658121712/f5e99b3cd6755fa06d1c513a/image.png?expires=1794511800&signature=7d7a111835f55a37494a1c276cbe2a2956c710e864dd00651443f755c2dfe50e&req=ciUvF8t%2FmoBdFb4f3HP0gFZhrbNVZfWL5ddEZTNN0OXmcSrkmB%2FH76FAc4nf%0AYAHtXboOnGv74ALG%2Bg%3D%3D%0A)](https://downloads.intercomcdn.com/i/o/658121712/f5e99b3cd6755fa06d1c513a/image.png?expires=1794511800&signature=7d7a111835f55a37494a1c276cbe2a2956c710e864dd00651443f755c2dfe50e&req=ciUvF8t%2FmoBdFb4f3HP0gFZhrbNVZfWL5ddEZTNN0OXmcSrkmB%2FH76FAc4nf%0AYAHtXboOnGv74ALG%2Bg%3D%3D%0A)

Edit the job by clicking the Job Name or Type,

[![](https://downloads.intercomcdn.com/i/o/658121946/d5992a85614bd23521e887e2/image.png?expires=1794511800&signature=3b9c8957f4a98d2e1ffcfdb612e85fbb285b44117e78bdd573f4418f5859a2cd&req=ciUvF8t%2FlIVZFb4f3HP0gIkoHaVoUCNok8DDNuOmWJtP%2BK01%2BbQBYeoHYCm%2F%0ANpc2LIKJQ6nSLi%2F%2FaQ%3D%3D%0A)](https://downloads.intercomcdn.com/i/o/658121946/d5992a85614bd23521e887e2/image.png?expires=1794511800&signature=3b9c8957f4a98d2e1ffcfdb612e85fbb285b44117e78bdd573f4418f5859a2cd&req=ciUvF8t%2FlIVZFb4f3HP0gIkoHaVoUCNok8DDNuOmWJtP%2BK01%2BbQBYeoHYCm%2F%0ANpc2LIKJQ6nSLi%2F%2FaQ%3D%3D%0A)

Clear any value from the `wsdl` option if it is displayed:

[![](https://downloads.intercomcdn.com/i/o/658121119/ec54767d441837ccce79172d/image.png?expires=1794511800&signature=e7e4e41691f904380000b8830224b3f7d554c974d18926e77a8f627a87d8bc8b&req=ciUvF8t%2FnIBWFb4f3HP0gLylLHiesJw97XdILcDDrIZ3nMJQCXnfVeMFEsqa%0AvqXop8Qi7xbsvNMM%2FA%3D%3D%0A)](https://downloads.intercomcdn.com/i/o/658121119/ec54767d441837ccce79172d/image.png?expires=1794511800&signature=e7e4e41691f904380000b8830224b3f7d554c974d18926e77a8f627a87d8bc8b&req=ciUvF8t%2FnIBWFb4f3HP0gLylLHiesJw97XdILcDDrIZ3nMJQCXnfVeMFEsqa%0AvqXop8Qi7xbsvNMM%2FA%3D%3D%0A)

Provide the value `partner.55.wsdl.xml` or `partner.50.wsdl.xml` for the `partner_wsdl` option.

If the `partner_wsdl` is not displayed, add it as shown below:

[![](https://downloads.intercomcdn.com/i/o/658122787/5d1e1f66b7bf4cd2f4fd43af/image.png?expires=1794511800&signature=c79982cdbaec9ec2c8ffbe707f734102a7dd3ee4d9257c91f93f8fd70b46fd82&req=ciUvF8t8molYFb4f3HP0gLHMLvsqKjVAUGVHttbWRqADXyl28kPuep0fdzes%0AYd%2BQsm2bjqIA%2BH2q2A%3D%3D%0A)](https://downloads.intercomcdn.com/i/o/658122787/5d1e1f66b7bf4cd2f4fd43af/image.png?expires=1794511800&signature=c79982cdbaec9ec2c8ffbe707f734102a7dd3ee4d9257c91f93f8fd70b46fd82&req=ciUvF8t8molYFb4f3HP0gLHMLvsqKjVAUGVHttbWRqADXyl28kPuep0fdzes%0AYd%2BQsm2bjqIA%2BH2q2A%3D%3D%0A)

Save the job and Force it as shown:

[![](https://downloads.intercomcdn.com/i/o/658123437/ecd458b32d83496482ea3bcf/image.png?expires=1794511800&signature=0cb0770d981bf4d820c402a97baf3d8058a28058cc5c5a65bb53b23161f9b47a&req=ciUvF8t9mYJYFb4f3HP0gLT27aRnbJ%2FeaFLLFn3fkpm83CnN0Osgh13YBcCi%0AMG8adbAT7J8lKt0oVg%3D%3D%0A)](https://downloads.intercomcdn.com/i/o/658123437/ecd458b32d83496482ea3bcf/image.png?expires=1794511800&signature=0cb0770d981bf4d820c402a97baf3d8058a28058cc5c5a65bb53b23161f9b47a&req=ciUvF8t9mYJYFb4f3HP0gLT27aRnbJ%2FeaFLLFn3fkpm83CnN0Osgh13YBcCi%0AMG8adbAT7J8lKt0oVg%3D%3D%0A)

You will receive an error or confirmation of success via email.

If you see the following error:

_Error. Salesforce said: Element {}item invalid at this location_

This is an indication you are using the **Enterprise WSDL**, when instead the **Partner WSDL** should be provided.