Print and Mail FAQAddress Verification FAQ
API Reference

Create Targeted List Build

post
https://api.postgrid.com/print-mail/v1/targeted_list_builds

Create a new targeted list build. A quote will be generated asynchronously based on the provided filters.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

The filters and metadata for the new list build.

string

An optional string describing this resource. Will be visible in the API and the dashboard.

metadata
object

See the section on Metadata.

usConsumers
object

Filters used to target US consumers (B2C) when building a list.

The geographic filters (zipCodesAround, cityStates, zipCodes) are mutually exclusive — you may supply at most one of them.

usCompanies
object

Filters used to target US companies (B2B) when building a list.

int32
≥ 1

Maximum number of contacts to include in the built mailing list. If omitted, all matching contacts are included.

Headers
string
Responses

Updated 1 day ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 1 day ago