Skip to main content
A synthetic contact data generator creates contact records for software testing, CRM fixtures and product demos. Spotzee returns email addresses and website URLs, with optional phone numbers, username fields, display names and social profile URLs when you enable those fields.
Run this generator at /tools/contact-generator.

​
Why this matters

Production records do not belong in development databases, demo screens or automated test fixtures. Synthetic contact data gives you realistic email, website, phone and account shapes without copying customer records into lower-control environments. Optional fields are where contact workflows often break. And a contact data generator with toggles for phone numbers, social URLs, account fields, reserved example domains, custom domains and deterministic seeds lets you test missing-field and long-field paths before users find them. Each Extended API call deducts a small per-call amount from your Spotzee credit balance. See live per-tool pricing on the Spotzee pricing page.

​
How it works

1

Send the request

POST to /generic/data/generate/contact with a count from 1 to 100, plus optional locale, seed, include flags, phoneStyle and emailDomain.
2

Choose optional fields

Set includePhone, includeSocial or includeAccount to true when you need phone, social profile, username or display-name output.
3

Control email output

Use useExampleEmail=true for reserved example-domain output, or pass emailDomain to generate addresses on one domain. Do not combine those options.
4

Return the records

The response returns data.contacts[]. Each record contains email and website, plus phone, username, displayName and social only when requested.

​
What to watch for

  • Count outside 1 to 100. The API accepts up to 100 contact records per request. For larger datasets, call the endpoint multiple times.
  • Reserved and custom domains together. Do not combine useExampleEmail=true with emailDomain; choose reserved example-domain output or one custom domain.
  • Invalid custom domain. Use a single domain such as example.org; blank labels, invalid characters and subdomain-style values are rejected.
  • Missing optional fields. phone, username, displayName and social only appear when their matching include option is enabled.
  • Invalid seed. Seeds must be whole numbers. Leave the field blank for random output, or reuse a numeric seed for repeatable fixtures.

​
FAQs

No. Synthetic contact data is generated sample data, not customer data. Use it in development databases, product demos and automated tests instead of copying production records.
The contact data generator always returns email and website. It can also return phone, username, displayName and social fields containing twitter, linkedin and github URLs when you request those options.
Yes. Enter a domain such as example.org in the email domain field to generate all contact emails on that domain. Do not enable reserved example-domain output at the same time, because the API rejects that combination.
Yes. Enter a numeric seed to reproduce output for the same count, locale and option set. Leave the seed blank when you want random sample contact data for exploratory testing.
No. Generated contacts are test fixtures, not deliverability test inboxes. Use the email spam checker or SMTP email test when you need to test a real message path.
This page covers the contact endpoint. For adjacent workflows, read the person generator guide, name generator guide, and date generator guide.

​
Try it

Generate sample contact records at spotzee.com/tools/contact-generator. Use the page as a sample contact data generator for one-off checks, or call the Extended API endpoint directly with your Spotzee API key.