Salesforce Input Tool Help Page Use the Salesforce Input tool to query your tables from Salesforce.com and read them into Designer. Current version Salesforce Input Tool v5.0.10 (June 28, 2023) * Compatible with Designer 2021.4.2 Patch 6, 2022.1 Patch 4 and later. * Compatible with AMP engine only. * Added support for DCM. * DCM is required for running this connector in Alteryx Server. * FIPS capable. * Added support for OAuth authentication and custom domains. * Fixed issue where Salesforce Input didn’t show all fields and objects. (TPM-1579) * Fixed issue where Salesforce Input incorrectly parsed PAC file. (TFLN-1243) * Fixed issue where Salesforce Input didn’t display the configuration window when Designer language was set to French. (TDCE-119) Known issues * Reports lists only Recent reports, not all the Reports available to the user. * Reports return only the first 2000 records. Previous versions Salesforce Input Tool v4.2.4 (April 28, 2021) * Compatible with Alteryx version 2019.3 and later. * If the query filters on a date using the Salesforce Object Query Language (SOQL) datetime syntax, we now parse and return data effectively (DE21310). * Unsupported JSON parsing will produce a message informing the customer that the results will be output as unparsed JSON. * Existing Report query option error has been resolved. * Existing Report workflows can be run from command line without needing to first select options from Query Builder (DE17748). * If Salesforce access is provisioned by IP address, users can now successfully publish to Gallery without a security token (DE28633). * Required Python package updates. Salesforce Input Tool v4.1.0 (June 18, 2019) * Added support for connecting through a proxy using auto detection and configuration. * Compatible with Alteryx version 2019.2 and up. Salesforce Input Tool v4.0.0 (August 27, 2018) * Added ability to query Salesforce Reports. * Query Builder and Custom Query return all records (including deleted) by default. * Add 'IsDeleted=False' in WHERE clause to exclude deleted records. * Compatible with Alteryx version 2018.3 - 2019.2. Salesforce Input Tool v3.1 (March 30, 2018) * Fixes defects for Record Limit under Runtime tab of workflow configuration and passwords containing XML special characters. * Compatible with Alteryx version 11.0 - 2018.2. This tool uses a .yxi file format. A .yxi file is a package that includes an Alteryx Tool and all of its dependencies zipped into a single file. When this file is imported into Alteryx, the tool is added to the tool palette in the category specified by the tool. When sharing a workflow that uses a .yxi tool, the tool is not included and must be installed by the recipient. SalesforceInput_v5.0.10.yxi

Is there a limitation of object relationship that we can query using this tool? Whenever I'm trying to join >= 3 relationships, Salesforce Input tool is not returning any values on those. Example: Primary Object: Opportunity Secondary Object: Contact Third Object: Account ---> information for columns associated to this object is not returned SELECT Id, Name, Contacts.Name, Contacts.Email, Contacts.Accounts.Name, Contacts.Accounts.Region FROM Opportunity From the above query, Salesforce Input Tool will not return values for the last 2 fields/columns.

Has anyone tried pushing SOQL queries with more than 2 object relationships? Example child_object1.child_object2.parent_object? I think the latest version does not support this. I have to split the queries to only have a maximum of 2 object relationship and have to join them using join tool. Anyone has any workaround on this one?

Did anybody ever solve the "Error: Salesforce Input (1): HTTPSConnectionPool(host='login.salesforce.com', port=443): Max retries exceeded with url: /services/oauth2/token (Caused by SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:1007)')))" error? I've just upgraded to the new tool and while I can link to Salesforce and see the tables and fields, I get this every time I run the query. It's just so frustrating... Cheers Colin

nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

Salesforce Input Tool

AlteryxProducts

ChatGPT Image May 12, 2026, 03_18_48 PM.png

Salesforce Input Tool Help Page

Use the Salesforce Input tool to query your tables from Salesforce.com and read them into Designer.

Current version

Salesforce Input Tool v5.0.10 (June 28, 2023)

Compatible with Designer 2021.4.2 Patch 6, 2022.1 Patch 4 and later.
Compatible with AMP engine only.
Added support for DCM.
- DCM is required for running this connector in Alteryx Server.
FIPS capable.
Added support for OAuth authentication and custom domains.
Fixed issue where Salesforce Input didn’t show all fields and objects. (TPM-1579)
Fixed issue where Salesforce Input incorrectly parsed PAC file. (TFLN-1243)
Fixed issue where Salesforce Input didn’t display the configuration window when Designer language was set to French. (TDCE-119)

Known issues

Reports lists only Recent reports, not all the Reports available to the user.
Reports return only the first 2000 records.

Previous versions

Salesforce Input Tool v4.2.4 (April 28, 2021)

Compatible with Alteryx version 2019.3 and later.
If the query filters on a date using the Salesforce Object Query Language (SOQL) datetime syntax, we now parse and return data effectively (DE21310).
Unsupported JSON parsing will produce a message informing the customer that the results will be output as unparsed JSON.
Existing Report query option error has been resolved.
Existing Report workflows can be run from command line without needing to first select options from Query Builder (DE17748).
If Salesforce access is provisioned by IP address, users can now successfully publish to Gallery without a security token (DE28633).
Required Python package updates.

Salesforce Input Tool v4.1.0 (June 18, 2019)

Added support for connecting through a proxy using auto detection and configuration.
Compatible with Alteryx version 2019.2 and up.

Salesforce Input Tool v4.0.0 (August 27, 2018)

Added ability to query Salesforce Reports.
Query Builder and Custom Query return all records (including deleted) by default.
Add 'IsDeleted=False' in WHERE clause to exclude deleted records.
Compatible with Alteryx version 2018.3 - 2019.2.

Salesforce Input Tool v3.1 (March 30, 2018)

Fixes defects for Record Limit under Runtime tab of workflow configuration and passwords containing XML special characters.
Compatible with Alteryx version 11.0 - 2018.2.

This tool uses a .yxi file format. A .yxi file is a package that includes an Alteryx Tool and all of its dependencies zipped into a single file. When this file is imported into Alteryx, the tool is added to the tool palette in the category specified by the tool.

When sharing a workflow that uses a .yxi tool, the tool is not included and must be installed by the recipient.

SalesforceInput_v5.0.10.yxi

Accepted answers

All comments

Danny-Farrar

I'm getting an error

"Error: Salesforce Input (7): Traceback (most recent call last):
File "main.py", line 10, in <module>
ModuleNotFoundError: No module named 'aiohttp'"

Does anyone know what that might be related to and how to resolve please?

Thanks!

amti

Also, this new connector only list regular names for objects, not API names, like the old input tools. Is this expected behavior? How do we distinguish between 2 objects with same name, but different API names if they're listed with the same name with this new Input tool? I'm confused ...

It seems that it's also not working properly in a marcro where we want to use the "SELECT ALL" for control parameter ...it simply does not select every fields. this worked for old connectors as well.
The problem with old connectors is that they don't see newest SFDC API, hence new standard objects won't show on those old ones.

jai_cotman

Getting error that the SELECT FIELDS(ALL) syntax is not supported in this version of the tool. Will this be updated soon, as having to input every field name in an object is extremely time consuming? Thanks!

pauldance

This new tool isn't great - all of the comments above are a step back from the previous tool (aside from the "FIELDS(ALL)" soql statement, as that wasn't available then either - but is definitely needed). My biggest frustration is the amount of failures it has. I regularly see:

Error: Salesforce Input: HTTPSConnectionPool(host='login.salesforce.com', port=443): Max retries exceeded with url: /services/oauth2/token (Caused by NewConnectionError('<urllib3.connection.HTTPSConnection object at 0x00000271A2014AF0>: Failed to establish a new connection: [WinError 10060] A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond'))

This is just an example from an object with less than 150 records, so it's hardly trying to retrieve much.

ondrouchch

Hi.

Received information from Salesforce that Salesforce will retire API version 7-20 on May 1, 2022. See https://help.salesforce.com/s/articleView?id=000351312&type=1. Seems that the Salesforce connector is using v 20.0. Do we plan to have an updated version?

BR, Ondrej

MichelleL

The Salesforce Input v4.0 - 4.3 are on API Version v42

rodgerh

I downloaded the Salesforceinput_v4.3.4.yxi file. How do I install it? When I open it it says "Windows can't open the file" and prompts me to select an app. What do I select?

MichelleL

@rodgerh - open with Alteryx Designer

jljones5

I have a user that is using this connector and he's showing on our side in Salesforce as making v20 requests. Does he need to somehow upgrade the tool in order for this to change? He only started using Alteryx recently, so he should have the most recent version that is listed above (v4.2.4). I'm not seeing anything more recent than that one.

MichelleL

@jljones5 Check the Salesforce Output tool version. An older version of this tool used v20. The latest version, Salesforce Output v1.3.1 uses v42.

jljones5

Michelle - I am not seeing how to do that... I tried downloading it myself and it appears to have downloaded v4.2.4 and I'm not seeing a way to check for a more updated version.

MichelleL

@jljones5 The Salesforce Output tool is located here: https://community.alteryx.com/t5/Public-Community-Gallery/Salesforce-Output-Tool/ta-p/877899

jljones5

Hi Michelle - sorry, I'm referring to the Input tool, not the Output tool. Our issue is with the Input.

MichelleL

@jljones5 I understand; however, I had a customer with the same issue last week (seeing v20). They thought it was caused by the Salesforce Input tool, and the culprit ended up being the Salesforce Output tool. It's just a guess, but that's what I'd recommend checking. If that's not the case, then I'd suggest opening a support ticket to investigate further.

Ari1

Does the Salesforce Input Tool Support SSO (Single Sign-On)?

-Ari

johnzrgu75

For version 4.2.4 and 4.1.0 error as below.

Traceback (most recent call last): File "main.py", line 76, in pi_init RuntimeError: Internal Error: DecryptPassword - buffer too small (Tool Id: 1)

ondrouchch

Need to upgrade to Salesforce Input Tool v4.2.4 in all my workflows. Is there some easy way to do it or do I have to manually replace the connectors one by one (will take ages...). Thanks for any hint.

pauldance

Hi @ondrouchch and all - I'm not sure if you're updating the tool in prep for the older API services being canned by Salesforce (https://help.salesforce.com/s/articleView?id=000354473&type=1), but i've taken a look at the JS for the input tool and it appears to be using v34 (safe for a little while longer).

SF Input Tool.png

I've also tested in one of our Saleforce UAT environments which has applied the API changes, and everything seems fine (both input and output tools).

I have the new version of the input tool, but just can't get it to work stably enough to use for production workflows. Hopefully the reprieve with the older Input and Output tools gives the @AlteryxProducts devs enough time to release a more stable set of tools to move to.

MichelleL

@ondrouchch - when I did this in my own workflows, I found that after I installed the new version of the connector, that my designer automatically picked it up. No extra work needed. If I happen to need to use the older version, it then gave me the option when I right clicked on the tool to choose a version. Hope this helps!

emilieAuzemery

Hello,

I am having issues working with Salesforce Input tool : configuration items do not appear (same problem as here : https://community.alteryx.com/t5/Alteryx-Designer-Discussions/Alteryx-Salesforce-Input-Tool-Can-t-be-configured-and-so-used/td-p/836016 )

Seems OK with Output Tool.

Any idea with what might be wrong?

Thank you

VaibhavKarandikar

SF input tool error.PNG I get the below error when trying to install the SF input tool V4.2.4. Please can anyone guide me on how i can overcome this error and successfully install the tool? thank you V

sharmaineebuenga

I am also encountering the same error ^. Kindly check on this. Thank you!

jeisey91

As of 6/14 I am seeing this tool listed as "Deprecated" and causing a "GONE" error code. This is effecting our workflow. Have others encountered this recent error and are there any known solutions?

cal_s

I can get nothing from the latest version of the Salesforce input tool except an error message:

Error: Salesforce Input (1): HTTPSConnectionPool(host='login.salesforce.com', port=443): Max retries exceeded with url: /services/oauth2/token (Caused by NewConnectionError('<urllib3.connection.HTTPSConnection object at 0x000001D670EB40B8>: Failed to establish a new connection: [Errno 11001] getaddrinfo failed',))

The strange thing is that the "validate" button on the SOQL query works fine and returns the number of results.

Has anyone else seen this error or found a solution ?

pauldance

@cal_s I see the same error - agree that it's weird it validates the query without issue but then seems to fail on run. I've not found a resolution, but thought I'd confirm you're no alone. Please @AlteryxProducts can you take a look at this :-(

amevy

I have been using this tool for awhile and have good experience so far but have not worked on any larger datasets. My Question is has anyone been able to parameterize the login credentials as the client secret often changes and i have many Orgs that i am connecting to. I was thinking of storing in user constant and referencing in the login if possible, this way if any changes to login i just change one place. Any ideas appreciated

mmurarik

Another issue I have with 4.0.0 and 4.2.4 is that I can no longer dynamically pass multiple tables through a macro and have a Control Parameter plus Action update the Table and/or Where clause values. Instead, I have to update the actual SOQL query that the Input tool builds out. Problem is, as mentioned above, the SELECT clause cannot accept an asterisk or FIELDS(ALL). So it throws a 400: Bad Request error since the default table within the macro obviously has it's own set of unique fields not found in the other tables getting processed. More info here:

https://community.alteryx.com/t5/Alteryx-Designer-Discussions/Extracting-multiple-tables-from-Salesforce/td-p/18592

cal_s

I tried the steps in this post as well, still no luck....

https://community.alteryx.com/t5/Alteryx-Designer-Knowledge-Base/Connection-Errors-with-Python-based-Connector-Tools-when-running/tac-p/813899#M6900

claudepromonet

With deployment of Summer 22 version, it is no more possible to use API SOAP v20.0 that has been deleted, what is making Salesforce Input v4.2.4 impossible to use.

Is there a more recent version of this Salesforce input connector or should I patch it manually ? and How?

Thanks

BGirkins

@claudepromonet v4.2.4 is on the current version of the API. The issue is that tool is full of errors and no word from Alteryx on plans for a new one. All I hear is to use ODBC instead but that thing is full of issues too (for example, you can't use Date Literals) and you have to convert all WHERE clause syntax to SQL (but we've had issues with that too). Very frustrating. The most stable Salesforce Input tool is the deprecated one in Designer 2021.4, go figure. That one is not based on Python. Problem is, it is removed from Designer in 2022.1+. So you have to replace them before an upgrade, but then you start getting all these traceback errors and it doesn't play nice with non-AMP modules unless you upgrade to 2022.1+. But unfortunately v4.2.4 doesn't work within Macros (what the individual mentioned above about dynamically replacing Table or WHERE clause) so can't upgrade until that is fixed. So it's just this circular path of errors.

Quick Links

Popular Tags

This months top contributors

atcodedog05 19598

Qiu 15908

binu_acs 15783

MarqueeCrew 13710

apathetichell 13703