A bulk can take a while, and you don't have to watch it. Tomba can tell you when it's done by email, with a browser notification or with a webhook. You can also rename, archive and delete bulks to keep your list tidy.
Get an email when a bulk is ready
Step 1. On the new bulk form, tick Email me when it is ready, just above Start bulk. It says "Receive an email when the bulk has finished."
Step 2. Click Start bulk. You can leave the page.
When the bulk finishes with results, you get an email with the subject "Your bulk job is ready". It names the bulk and the number of results, and its Download results button opens the bulk in Tomba. The email goes to your account's email address.
If the bulk finds nothing, no email is sent. The bulk's page says "No results found", and nothing was charged.
Get a browser notification
While a bulk runs, its page says "You can leave this page: the bulk keeps running."
Step 1. On the running bulk's page, click the bell icon next to Cancel. Its tip says "Get a browser notification when it finishes".
Step 2. If your browser asks, allow notifications for Tomba. Tomba says "You will be notified when the bulk finishes".
Step 3. Keep the bulk's page open in a tab. You can work in other tabs or windows.
When the bulk finishes, your browser shows a notification such as "Q3 prospects is ready" and "120 found. Download your results." It only appears when you aren't looking at the bulk's page.
What does "Notifications are blocked" mean?
Your browser isn't allowing Tomba to show notifications. Tomba says "Notifications are blocked" and "Allow them in your browser settings."
To allow them in Chrome:
On the Tomba page, click the icon at the left of the address bar, called View site information.
Turn on Notifications.
Click the bell icon on the bulk's page again.
If Tomba says "Notifications are not supported by this browser", use the email instead.
Send a webhook when a bulk finishes
A webhook is a message Tomba sends to another app's web address. Use it if another app should start working as soon as a bulk ends.
Step 1. On the new bulk form, tick Send a webhook when it finishes. Tomba sends the message when the bulk completes, fails or is cancelled.
Step 2. Paste the address under Webhook URL. It must start with https://. Otherwise, the form says "The webhook URL must start with https://" or "Enter a valid URL, like https://example.com/hooks/tomba".
Step 3. Click Start bulk.
The signing secret
The signing secret is for the person who set up the app that receives the webhook. That app uses it to check that each message really comes from Tomba. Click Show signing secret to see it, and copy it to them.
Rotate makes a new secret. Tomba asks "Rotate the signing secret?" and warns: "Webhooks are signed with the new secret right away. Update your receiver first." The old secret stops working, so give the new one to that person straight away.
What does "You may not have enough credits" mean?
A bulk's page shows this when your credits may not cover the download. It adds "You can still run it: credits are charged on the first download, for what is actually found." Use Upgrade if you want more credits now.
When the bulk has finished and you're short of credits, Download CSV changes to Upgrade to download, and the page says "You do not have enough credits left for this download", with the number of credits needed.
💳 Credits: Notifications, webhooks, renaming, archiving and deleting cost nothing. You pay for a bulk on its first download.
Rename a bulk
Step 1. Open the bulk. At the top of the page, click its name.
Step 2. Choose Rename, type the new name and click Save. Tomba says "Bulk renamed".
A name must be 3 to 200 characters long. Otherwise, Tomba says "The name must be 3 to 200 characters long."
Archive and restore bulks
Archiving moves a bulk out of your main list, without deleting it or its results. You can archive a bulk that's completed, failed or cancelled.
Step 1. In your list of bulks, click the three dots at the end of the bulk's row and choose Archive. On a bulk's page, click its name at the top and choose Archive.
Step 2. Tomba asks you to confirm, with the bulk's name or "Archive this bulk?", and says "It moves to your archived bulks. You can restore it at any time." Click Archive.
To see your archived bulks, switch the list from Active to Archived. To bring one back, click the three dots on its row and choose Restore. Tomba says "Bulk restored".
Cancel a running bulk
Step 1. Open the running bulk and click Cancel.
Step 2. Tomba asks "Cancel this bulk?" and says "Processing stops and nothing is charged. You can retry it later." Click Cancel bulk.
To run it again later, open the bulk and click Retry.
Delete a bulk
Step 1. Click the three dots at the end of the bulk's row and choose Delete. On a bulk's page, click its name at the top and choose Delete.
Step 2. Tomba asks you to confirm, with the bulk's name or "Delete this bulk?", and says "The bulk and its results are deleted. This cannot be undone." Click Delete.
⚠️ Important: Download the results you need first. A deleted bulk can't be brought back. To hide a bulk without losing it, archive it instead.
Related articles
