---
title: Bulk Verification Embed Guide | PostGrid
description: How to embed PostGrid's bulk address verification tool into your own website using an iframe, including setup, configuration options, and secret management.
---

## Introduction

This guide will show you how you can `iframe` PostGrid’s [bulk verification tool](https://app.postgrid.com/dashboard/bulk_verify) into your own websites. Note that this feature is not available by default. Please contact `support@postgrid.com` to request access to the feature.

## Creating an Embed Secret

Once the feature has been enabled for your organization, you can log into the PostGrid address verification dashboard and head to the [profile](https://app.postgrid.com/dashboard/profile) page. At the bottom of this page, you should see a section that lets you create your embed secret:

![Embed Secrets Section](/_astro/01-image.PSvPAM9p_NeVlJ.webp)

Clicking on `Create New Secret` should result in a secret and user ID becoming available for you to show and then copy.

![Currently Active Secret](/_astro/02-image.BqIOSLfT_Z1Ud3qa.webp)

Once you’ve created this secret, you can click on the `Copy URL` button to get a link to the bulk verification embed page.

This link can then be set as the `src` attribute on an `iframe` tag.

## Configuring your embedded integration

You can configure your integration by supplying query parameters in your iframe link. The following table displays all possible configuration options.

| Query Parameter                 | Description                                                              | Type      | Default |
| ------------------------------- | ------------------------------------------------------------------------ | --------- | ------- |
| `hideChat`                      | Hides the PostGrid support chat box                                      | `boolean` | `false` |
| `hideInternationalVerification` | Hides the option of performing international verification for bulk lists | `boolean` | `false` |

To customize your configuration, supply the desired configuration options along with your `id` and `secret` in the `iframe` URL you copied earlier. The following is an example configuration which hides the support chat box: `https://app.postgrid.com/embed/bulk_verify?id={YOUR USER ID HERE}&secret={YOUR EMBED SECRET HERE}&hideChat=true`.

> 📘 Note
>
> You must omit the curly braces in-place for your actual user ID and embed secret. If you are unsure about your user ID and embedded secret, you can find out on your [profile page](https://app.postgrid.com/dashboard/profile).

## Retiring embed secrets

In the event that you would like to rotate or remove your embed secret, you can click the “Retire” button under your embed secret in your profile page. This will disable all existing frames using this secret.