Dropbox Integration

Automatically upload files from a form’s File Upload field to a Dropbox folder, so attachments are saved to your cloud storage as soon as visitors upload them. Dropbox requires Contactum Pro with the Dropbox module enabled.

---

Requirements #

• Contactum Pro, with the Dropbox module active (Contactum → Modules)
• A Dropbox account and an app registered in the Dropbox App Console
• Your app’s App Key and App Secret

---

1. Create a Dropbox App #

1. Go to the Dropbox App Console and create a new app.
2. Copy the app’s App Key and App Secret.
3. In the app’s settings, add the exact Redirect URI Contactum shows you (see step 2 below) to the app’s Redirect URIs list.

---

2. Connect Dropbox in Contactum #

1. Go to Contactum → Settings → Integrations → Dropbox.
2. Paste in your App Key and App Secret.
3. Optionally set a Path Prefix — a leading folder applied to every upload (default: /contactum-uploads), created automatically if it doesn’t exist.
4. Copy the Redirect URI shown on the page ({your-site}/wp-admin/?contactum_dropbox_auth=1) into your Dropbox app’s Redirect URIs list, if you haven’t already.
5. Click Connect Dropbox.

You’re redirected to Dropbox to authorize the connection. After you approve it, Dropbox sends you back to Contactum and the status badge turns green. Unlike API-key integrations, Contactum doesn’t run a separate live test here — the connection is only confirmed once the full authorization round-trip completes.

To disconnect, click Disconnect Dropbox — this clears the stored tokens and stops all uploads until reconnected.

---

3. Enable Dropbox on a Specific Form #

1. Open the form in the builder.
2. Go to Form Settings → Integrations.
3. Toggle Dropbox on, then click Configure.

---

4. Configure Upload Settings #

Field	Description
Enable Dropbox for this form	Turns Dropbox uploads on for this specific form
Folder	A folder path appended after the global Path Prefix, e.g. form-7 (leave blank to use just the global default). This is a typed path, not a picker — double-check spelling, since Dropbox will silently create a new folder for a typo rather than erroring
Delete local copy after upload	Removes the file from your WordPress server once it’s safely uploaded to Dropbox

There’s no field mapping here — Dropbox uploads files, not contact records.

---

5. How It Works #

Unlike most integrations, Dropbox doesn’t wait for the form’s final Submit click — it acts as soon as a visitor selects a file in a File Upload field:

1. Contactum checks the form has Dropbox enabled (or, if the upload happens outside a form context, that Dropbox is connected at all).
2. The destination path is built from the global Path Prefix + this form’s Folder + the original filename.
3. The file is uploaded to Dropbox without overwriting existing files — if a file with the same name already exists at that path, Dropbox automatically renames the new one (e.g. adding ” (1)”).
4. On success, Contactum stores a Dropbox link on the file’s WordPress attachment. This link only opens correctly for whoever is logged into the connected Dropbox account — it is not a public URL, since Dropbox uploads are private by default.
5. If Delete local copy after upload is enabled, the file is removed from your server after a successful upload.

Important: because uploads are tied to the file-select step, a file can be pushed to Dropbox even if the visitor never actually finishes and submits the form. A failed upload does not block form submission and is recorded in Contactum’s API Log for review.

---

Troubleshooting #

Files aren’t uploading to Dropbox #

1. Confirm the form has Dropbox toggled on and was saved.
2. Confirm the global connection still shows verified — an expired or revoked authorization will block all uploads until you reconnect.
3. Check the API Log (Contactum → Tools → API Log, if available in your version) for a logged failure and its error message.

Connecting keeps failing / redirect loop #

• Double-check the Redirect URI registered in your Dropbox app matches Contactum’s shown value exactly, including https:// and no trailing slash mismatch.

Files are landing in the wrong folder #

• The Folder field is a free-typed path, not a picker — reconfirm spelling in the form’s Configure dialog and the global Path Prefix.

I’m seeing duplicate-looking files with “(1)” appended #

• Dropbox never overwrites an existing file with the same name at the same path — this is expected behavior when the same filename is uploaded more than once (e.g. repeat test submissions).

---

Notes #

• Requires Contactum Pro with the Dropbox module active — not available in the free plugin.
• Auth method: OAuth2 with a refresh token — you authorize once via the Connect button; Contactum silently refreshes the access token as needed.
• Credentials storage: app keys and tokens are stored in wp_options under the key contactum_dropbox.
• Uploaded file links are private to the connected Dropbox account, not public URLs.