Skip to content

Generate a New Seed List

Request

Security
basicAuth
Query
sending_domainsstring

Deprecated.

namestring
provider_filterstring

Array of provider domains. Omitting means all providers.

remote_idstring
curl -i -X POST \
  -u '<username>:<password>' \
  'https://api.mailgun.net/v4/inbox/seedlists?sending_domains=string&name=string&provider_filter=string&remote_id=string'

Responses

A 200 response

Bodyapplication/json
kidstringrequired
created_atstring, (date-time)required
updated_atstring, (date-time)required
last_result_atstring, (date-time)required
target_emailstringrequired
sending_domainsArray of stringsrequired
has_resultsbooleanrequired
namestringrequired
seed_filterstringrequired
provider_filterArray of stringsrequired

[] means all providers; null means that only seed_filter is used

mailing_liststringrequired
previous_mailing_liststringrequired

List before last regen

tagsobjectrequired
delivery_statsobject
is_auto_generatedbooleanrequired
versioninteger, (int32)required
regen_neededbooleanrequired

Shows that mailing_list has to many unavailable seeds. Only for v2 Seed List.

regen_atstring, (date-time)required
max_seeds_per_providerinteger, (int32)required

Maximum number of seeds per provider. 0 means no limit.

Response
{ "created_at": "0001-01-01T00:00:00Z", "updated_at": "0001-01-01T00:00:00Z", "last_result_at": "0001-01-01T00:00:00Z", "regen_at": "0001-01-01T00:00:00Z" }