Documentation » Contacts

ZeroBounce

Published · Last updated

Bounced emails hurt your sender reputation. When too many of your emails go to addresses that don’t exist, email providers start sending your mail to spam, and your sending service may pause your account. The ZeroBounce integration checks your contacts’ email addresses with ZeroBounce so you only send to real, working inboxes.

ZeroBounce flags addresses that are invalid, belong to known complainers, are spam traps, or shouldn’t be mailed. Groundhogg then marks those contacts as unmarketable, so they won’t receive marketing emails. They’ll still receive transactional emails like receipts and password resets.

What you’ll need

Get your ZeroBounce API key

  1. Log in to your ZeroBounce account.
  2. Go to the API section and open the API Keys page.
  3. Copy your existing key, or click Add New API Key to create one just for your website. A separate key makes it easy to turn off access later without affecting anything else.

Connect ZeroBounce to Groundhogg

  1. Install and activate the ZeroBounce Integration add-on.
  2. In your WordPress admin, go to Groundhogg > Settings > Integrations and find the ZeroBounce section.
  3. Paste your key into the API key field and click Save Changes.
  4. Click Test Connection to make sure Groundhogg can reach your ZeroBounce account.
  5. Under Which email statuses should impact marketability?, choose the results that should stop a contact from getting marketing emails. We recommend Invalid, Abuse, Spam Trap and Do Not Mail.
  6. Decide whether to check free email addresses. By default, addresses at free providers like Gmail, Outlook and Yahoo aren’t checked and are treated as valid, which saves credits. If a lot of your contacts use free email addresses, enable Validate public/free email addresses? so those get checked too.
  7. Click Save Changes.

How validation works

Once connected, Groundhogg checks your contacts automatically over time, including new contacts as they sign up.

Only contacts with the Unconfirmed opt-in status are checked. Every other status already involves a confirmation from the contact or from you, so checking them again wouldn’t add anything.

Validate your existing contacts

Before emailing a list you haven’t mailed in a while, like an old import, check it first so dead addresses don’t bounce.

  1. Go to Groundhogg > Tools.
  2. In the ZeroBounce box, click Force Validate.
  3. Use the filters to choose which contacts to check, for example a tag or a saved search. This keeps you from spending credits on contacts you don’t need to check. Leave the filters empty to check your whole list.
  4. Start the validation. Contacts are re-checked even if they were validated before.

View the validation report

To see how validation affected your list, go to Groundhogg > Tools and click View Report in the ZeroBounce box. From there you can review the results and make manual adjustments.

Fix a false positive

Sometimes ZeroBounce gets it wrong. If you know an address is good, open the contact’s profile, set their ZeroBounce status to Valid and save. They’ll be marketable again.

Import contacts with a ZeroBounce status

If you’ve already checked a list in ZeroBounce, you can import the results instead of checking those contacts again. Make sure your CSV file has an Email column and a ZB Status column. When you map the fields during the import, map the ZB Status column to ZB Status under ZeroBounce.

Still stuck? Contact support and we’ll help you sort it out.