{"componentChunkName":"component---src-templates-markdown-template-jsx","path":"/guides/csv/sftp-credentials/","result":{"data":{"pageMetadata":{"title":"SFTP Credentials","path":"/guides/csv/sftp-credentials/","sourceCode":null,"metadataParent":{"title":"Import Data with CSV Files","path":"/guides/csv/","sourceCode":null,"hasVersionPicker":null,"metadataChildren":[{"title":"Import Data with CSV Files","path":"/guides/csv/import/","order":1,"label":null},{"title":"CSV File Reference","path":"/guides/csv/reference/","order":2,"label":null},{"title":"SFTP Credentials","path":"/guides/csv/sftp-credentials/","order":3,"label":null}],"metadataParent":{"title":"Guides","path":"/guides/","metadataChildren":[{"title":"Customer 360","path":"/guides/customer-360/","order":1,"label":null},{"title":"Getting Started","path":"/guides/getting-started/","order":1,"label":null},{"title":"Platform Guide","path":"/guides/platform-guide/","order":2,"label":null},{"title":"IDSync","path":"/guides/idsync/","order":4,"label":null},{"title":"Segmentation","path":"/guides/segmentation/","order":4,"label":null},{"title":"Analytics","path":"/guides/analytics/","order":7,"label":null},{"title":"Warehouse Sync","path":"/guides/data-warehouse-sync/","order":7,"label":null},{"title":"Data Privacy Controls","path":"/guides/data-privacy-controls/","order":8,"label":null},{"title":"Data Subject Requests","path":"/guides/data-subject-requests/","order":9,"label":null},{"title":"Default Service Limits","path":"/guides/default-service-limits/","order":10,"label":null},{"title":"Feeds","path":"/guides/feeds/","order":11,"label":null},{"title":"Cross-Account Audience Sharing","path":"/guides/cross-account-audience-sharing/","order":12,"label":null},{"title":"Import Data with CSV Files","path":"/guides/csv/","order":13,"label":null},{"title":"Glossary","path":"/guides/glossary/","order":14,"label":null},{"title":"Video Index","path":"/guides/video-index/","order":15,"label":null},{"title":"Analytics (Deprecated)","path":"/guides/analytics-deprecated/","order":16,"label":null},{"title":"Composable Audiences","path":"/guides/composable-audiences/","order":null,"label":null}],"metadataParent":null}}},"markdownRemark":{"html":"<p>mParticle hosts a managed SFTP endpoint you can use to import bulk data in CSV files. To send data to the SFTP endpoint, you will need a username and password that you can create yourself from the <strong>SFTP Provisioning</strong> tab in your mParticle platform settings. Currently, one SFTP username per organization is supported, for all accounts and workspaces under that organization.</p>\n<p>You can also use the SFTP Provisioning page to provision a new SFTP user, reset a SFTP password, or disable SFTP access.</p>\n<aside>\nYou must have an <b>Admin</b> user role to provision and manage SFTP credentials. If the <b>SFTP Provisioning</b> tab is not available in your mParticle platform settings, contact an administrator on your team.\n</aside>\n<h2 id=\"provision-an-sftp-user\" style=\"position:relative;\"><a href=\"#provision-an-sftp-user\" aria-label=\"provision an sftp user permalink\" class=\"anchor before\"><svg width=\"16px\" height=\"17px\" viewBox=\"0 0 16 17\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n                <g id=\"Symbols\" stroke=\"none\" stroke-width=\"1\" fill=\"none\" fill-rule=\"evenodd\">\n                    <g id=\"Icon/Link\" fill=\"#98A0A3\" fill-rule=\"nonzero\">\n                        <g id=\"link\">\n                            <path d=\"M9.5,12.4 C9.6,12.4 9.7,12.4 9.9,12.4 C9.8,12.5 9.8,12.5 9.7,12.6 L7.5,14.8 C5.8,16.5 3,16.5 1.3,14.8 C-0.4,13.1 -0.4,10.3 1.3,8.6 L3.5,6.4 C3.6,6.3 3.6,6.3 3.7,6.2 C5,5 6.9,4.8 8.4,5.5 C8.8,5.7 9.3,6 9.6,6.4 C10,6.7 10.2,7.2 10.5,7.6 C10.2,7.9 9.9,8 9.5,8 C9.4,8 9.2,8 9.1,7.9 C8.9,7.5 8.5,7.2 8.1,6.9 C7,6.2 5.5,6.4 4.5,7.3 L3.8,8 L2.3,9.5 C1.2,10.6 1.2,12.5 2.3,13.6 C3.4,14.7 5.3,14.7 6.4,13.6 L7.9,12.1 C8.4,12.3 8.9,12.4 9.5,12.4 Z M14.7,1.3 C13,-0.4 10.2,-0.4 8.5,1.3 L6.3,3.5 C6.2,3.6 6.2,3.6 6.1,3.7 C6.7,3.7 7.4,3.7 8,3.9 L9.5,2.4 C10.6,1.3 12.5,1.3 13.6,2.4 C14.7,3.5 14.7,5.4 13.6,6.5 L12.1,8 L11.4,8.7 C10.4,9.7 8.9,9.8 7.8,9.1 C7.4,8.9 7.1,8.5 6.8,8.1 C6.7,8.1 6.5,8 6.4,8 C6,8 5.6,8.2 5.4,8.4 C5.6,8.8 5.9,9.3 6.3,9.6 C6.6,10 7.1,10.2 7.5,10.5 C9,11.2 10.9,11 12.3,9.8 C12.4,9.7 12.4,9.7 12.5,9.6 L14.7,7.4 C16.4,5.7 16.4,3 14.7,1.3 Z\" id=\"Shape\"></path>\n                        </g>\n                    </g>\n                </g>\n            </svg></a>Provision an SFTP user</h2>\n<ol>\n<li>Log in to your mParticle account, click the <strong>Settings</strong> (gear) icon at the bottom of the left-hand navigation, and select <strong>Platform</strong>.</li>\n<li>From your Platform Settings, click the <strong>SFTP Provisioning</strong> tab. Here you will see your SFTP <strong>username</strong> and <strong>hostname:port</strong> for the SFTP endpoint where you can upload your CSV files.</li>\n<li>\n<p>Click <strong>Provision Credentials</strong>.</p>\n<p><img src=\"/images/csv/sftp-provisioning-form.png\" alt=\"screenshot of the SFTP Provisioning form showing the displayed username, hostname:port, and Provision Credentials button\"></p>\n</li>\n<li>\n<p>mParticle returns the username and a one-time password. <strong>Copy the password immediately</strong> — for security, it is shown once on this screen and cannot be retrieved later.</p>\n<p><img src=\"/images/csv/sftp-provisioning-result.png\" alt=\"screenshot of the result screen showing the customer_OrgID username and one-time password\"></p>\n</li>\n<li>Store the username and password in your team’s secrets manager (1Password, HashiCorp Vault, AWS Secrets Manager, etc.).</li>\n</ol>\n<p>The drop-folder path is not displayed on this screen. It will be provided when you configure the Custom CSV Feed as described in <a href=\"/guides/csv/import/#3-configure-the-custom-csv-feed\">Configure the Custom CSV Feed</a>.</p>\n<h2 id=\"reset-a-password\" style=\"position:relative;\"><a href=\"#reset-a-password\" aria-label=\"reset a password permalink\" class=\"anchor before\"><svg width=\"16px\" height=\"17px\" viewBox=\"0 0 16 17\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n                <g id=\"Symbols\" stroke=\"none\" stroke-width=\"1\" fill=\"none\" fill-rule=\"evenodd\">\n                    <g id=\"Icon/Link\" fill=\"#98A0A3\" fill-rule=\"nonzero\">\n                        <g id=\"link\">\n                            <path d=\"M9.5,12.4 C9.6,12.4 9.7,12.4 9.9,12.4 C9.8,12.5 9.8,12.5 9.7,12.6 L7.5,14.8 C5.8,16.5 3,16.5 1.3,14.8 C-0.4,13.1 -0.4,10.3 1.3,8.6 L3.5,6.4 C3.6,6.3 3.6,6.3 3.7,6.2 C5,5 6.9,4.8 8.4,5.5 C8.8,5.7 9.3,6 9.6,6.4 C10,6.7 10.2,7.2 10.5,7.6 C10.2,7.9 9.9,8 9.5,8 C9.4,8 9.2,8 9.1,7.9 C8.9,7.5 8.5,7.2 8.1,6.9 C7,6.2 5.5,6.4 4.5,7.3 L3.8,8 L2.3,9.5 C1.2,10.6 1.2,12.5 2.3,13.6 C3.4,14.7 5.3,14.7 6.4,13.6 L7.9,12.1 C8.4,12.3 8.9,12.4 9.5,12.4 Z M14.7,1.3 C13,-0.4 10.2,-0.4 8.5,1.3 L6.3,3.5 C6.2,3.6 6.2,3.6 6.1,3.7 C6.7,3.7 7.4,3.7 8,3.9 L9.5,2.4 C10.6,1.3 12.5,1.3 13.6,2.4 C14.7,3.5 14.7,5.4 13.6,6.5 L12.1,8 L11.4,8.7 C10.4,9.7 8.9,9.8 7.8,9.1 C7.4,8.9 7.1,8.5 6.8,8.1 C6.7,8.1 6.5,8 6.4,8 C6,8 5.6,8.2 5.4,8.4 C5.6,8.8 5.9,9.3 6.3,9.6 C6.6,10 7.1,10.2 7.5,10.5 C9,11.2 10.9,11 12.3,9.8 C12.4,9.7 12.4,9.7 12.5,9.6 L14.7,7.4 C16.4,5.7 16.4,3 14.7,1.3 Z\" id=\"Shape\"></path>\n                        </g>\n                    </g>\n                </g>\n            </svg></a>Reset a password</h2>\n<p>If you’ve lost your password, you can create a new one from SFTP Provisioning:</p>\n<ol>\n<li>Click the <strong>Settings</strong> (gear) icon in the bottom of the left-hand navigation and select <strong>Platform</strong>. Click the <strong>SFTP Provisioning</strong> tab. </li>\n<li>Click <strong>Reset Password</strong>.</li>\n</ol>\n<p>mParticle generates a new password for the existing user. The previous password stops working immediately. Copy and store the new password as described above.</p>\n<p><img src=\"/images/csv/sftp-reset-password-result.png\" alt=\"screenshot of the result screen showing the customer_OrgID username and reset password\"></p>\n<aside>\nResetting the password does <strong>not</strong> change the username, delete the SFTP user, or affect any files already on the SFTP server. Only the password rotates.\n</aside>\n<h2 id=\"disable-sftp-access\" style=\"position:relative;\"><a href=\"#disable-sftp-access\" aria-label=\"disable sftp access permalink\" class=\"anchor before\"><svg width=\"16px\" height=\"17px\" viewBox=\"0 0 16 17\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n                <g id=\"Symbols\" stroke=\"none\" stroke-width=\"1\" fill=\"none\" fill-rule=\"evenodd\">\n                    <g id=\"Icon/Link\" fill=\"#98A0A3\" fill-rule=\"nonzero\">\n                        <g id=\"link\">\n                            <path d=\"M9.5,12.4 C9.6,12.4 9.7,12.4 9.9,12.4 C9.8,12.5 9.8,12.5 9.7,12.6 L7.5,14.8 C5.8,16.5 3,16.5 1.3,14.8 C-0.4,13.1 -0.4,10.3 1.3,8.6 L3.5,6.4 C3.6,6.3 3.6,6.3 3.7,6.2 C5,5 6.9,4.8 8.4,5.5 C8.8,5.7 9.3,6 9.6,6.4 C10,6.7 10.2,7.2 10.5,7.6 C10.2,7.9 9.9,8 9.5,8 C9.4,8 9.2,8 9.1,7.9 C8.9,7.5 8.5,7.2 8.1,6.9 C7,6.2 5.5,6.4 4.5,7.3 L3.8,8 L2.3,9.5 C1.2,10.6 1.2,12.5 2.3,13.6 C3.4,14.7 5.3,14.7 6.4,13.6 L7.9,12.1 C8.4,12.3 8.9,12.4 9.5,12.4 Z M14.7,1.3 C13,-0.4 10.2,-0.4 8.5,1.3 L6.3,3.5 C6.2,3.6 6.2,3.6 6.1,3.7 C6.7,3.7 7.4,3.7 8,3.9 L9.5,2.4 C10.6,1.3 12.5,1.3 13.6,2.4 C14.7,3.5 14.7,5.4 13.6,6.5 L12.1,8 L11.4,8.7 C10.4,9.7 8.9,9.8 7.8,9.1 C7.4,8.9 7.1,8.5 6.8,8.1 C6.7,8.1 6.5,8 6.4,8 C6,8 5.6,8.2 5.4,8.4 C5.6,8.8 5.9,9.3 6.3,9.6 C6.6,10 7.1,10.2 7.5,10.5 C9,11.2 10.9,11 12.3,9.8 C12.4,9.7 12.4,9.7 12.5,9.6 L14.7,7.4 C16.4,5.7 16.4,3 14.7,1.3 Z\" id=\"Shape\"></path>\n                        </g>\n                    </g>\n                </g>\n            </svg></a>Disable SFTP access</h2>\n<p>If you no longer need SFTP access for this organization, disable it from the same screen:</p>\n<ol>\n<li>Click the <strong>Settings</strong> (gear) icon in the bottom of the left-hand navigation and select <strong>Platform</strong>. Click the <strong>SFTP Provisioning</strong> tab. </li>\n<li>Click <strong>Disable</strong>.</li>\n</ol>\n<p><img src=\"/images/csv/sftp-disable-sftp.png\" alt=\"screenshot of the result screen showing the Disable option\"></p>\n<p>Disabling deprovisions the SFTP user — SSH access is removed immediately, any active sessions are terminated, and the username and password stop working.</p>\n<p>The action is reversible. To restore SFTP access later, return to the same screen and click <strong>Provision Credentials</strong>. A new password is issued; the old one does not come back.</p>\n<aside>\nDisabling does <strong>not</strong> delete files you've already uploaded to the SFTP server. Your data is preserved and is accessible again once SFTP access is re-provisioned.\n</aside>\n<h2 id=\"troubleshooting\" style=\"position:relative;\"><a href=\"#troubleshooting\" aria-label=\"troubleshooting permalink\" class=\"anchor before\"><svg width=\"16px\" height=\"17px\" viewBox=\"0 0 16 17\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n                <g id=\"Symbols\" stroke=\"none\" stroke-width=\"1\" fill=\"none\" fill-rule=\"evenodd\">\n                    <g id=\"Icon/Link\" fill=\"#98A0A3\" fill-rule=\"nonzero\">\n                        <g id=\"link\">\n                            <path d=\"M9.5,12.4 C9.6,12.4 9.7,12.4 9.9,12.4 C9.8,12.5 9.8,12.5 9.7,12.6 L7.5,14.8 C5.8,16.5 3,16.5 1.3,14.8 C-0.4,13.1 -0.4,10.3 1.3,8.6 L3.5,6.4 C3.6,6.3 3.6,6.3 3.7,6.2 C5,5 6.9,4.8 8.4,5.5 C8.8,5.7 9.3,6 9.6,6.4 C10,6.7 10.2,7.2 10.5,7.6 C10.2,7.9 9.9,8 9.5,8 C9.4,8 9.2,8 9.1,7.9 C8.9,7.5 8.5,7.2 8.1,6.9 C7,6.2 5.5,6.4 4.5,7.3 L3.8,8 L2.3,9.5 C1.2,10.6 1.2,12.5 2.3,13.6 C3.4,14.7 5.3,14.7 6.4,13.6 L7.9,12.1 C8.4,12.3 8.9,12.4 9.5,12.4 Z M14.7,1.3 C13,-0.4 10.2,-0.4 8.5,1.3 L6.3,3.5 C6.2,3.6 6.2,3.6 6.1,3.7 C6.7,3.7 7.4,3.7 8,3.9 L9.5,2.4 C10.6,1.3 12.5,1.3 13.6,2.4 C14.7,3.5 14.7,5.4 13.6,6.5 L12.1,8 L11.4,8.7 C10.4,9.7 8.9,9.8 7.8,9.1 C7.4,8.9 7.1,8.5 6.8,8.1 C6.7,8.1 6.5,8 6.4,8 C6,8 5.6,8.2 5.4,8.4 C5.6,8.8 5.9,9.3 6.3,9.6 C6.6,10 7.1,10.2 7.5,10.5 C9,11.2 10.9,11 12.3,9.8 C12.4,9.7 12.4,9.7 12.5,9.6 L14.7,7.4 C16.4,5.7 16.4,3 14.7,1.3 Z\" id=\"Shape\"></path>\n                        </g>\n                    </g>\n                </g>\n            </svg></a>Troubleshooting</h2>\n<ul>\n<li><strong>“SFTP provisioning failed”</strong> — a transient backend error. Wait a minute and retry. If the error persists, contact mParticle support.</li>\n<li><strong>SFTP login fails after provisioning</strong> — confirm you’re using the username exactly as displayed (<code class=\"language-text\">customer_&lt;OrgID&gt;</code>), the password exactly as copied (no leading or trailing whitespace), and the hostname shown in the Custom CSV Feed configuration.</li>\n</ul>","frontmatter":{"title":"SFTP Credentials","order":3,"seoTitle":null,"seoDescription":null},"parent":{"__typename":"File","modifiedTime":"May 8, 2026"}}},"pageContext":{"slug":"/guides/csv/sftp-credentials/"}},"staticQueryHashes":["2950460867"]}