Read Email Verification Link

TypeScriptUtility

POST api.upapi.io/email-read-verification-link.post

Connect to an IMAP mailbox and extract a link from the BODY of a recent email. Decodes quoted-printable/base64 bodies before matching, so URLs split across lines are returned whole. Polls with retries. Use this for verification mail whose token is a one-time URL rather than a code in the subject.

emailverificationimaputility

AuthAPI key

Cost1 unit

Timeout120s

CacheNone

Request schema

Field	Type	Description
`imapHost`	string	IMAP server hostname· default: `"imap.gmail.com"`
`imapPass`req	string	IMAP password or app password
`imapPort`	integer	IMAP server port· default: `993`
`imapUser`req	string	IMAP username (email address)
`mailboxes`	array	Mailboxes to search, in order. Omit to search INBOX plus whatever the server flags \All and \Junk (Gmail: All Mail and Spam) — providers routinely file one-time verification links as junk, and searching INBOX alone reports them as never sent.
`maxRetries`	integer	Number of polling attempts· default: `5`
`linkPattern`	string	Regex matched against the DECODED body. The first capture group is returned when present, otherwise the whole match. Default matches any http(s) URL.· default: `"https?://[^\\s\"'<>)\\]]+"`
`retryDelayMs`	integer	Milliseconds between retry attempts· default: `10000`
`senderFilter`req	string	Filter emails by sender (e.g. noreply@reddit.com)
`maxAgeMinutes`	integer	Only look at emails received within this many minutes· default: `15`
`subjectPattern`	string	Regex matched against the subject, to pick one of several mails from the same sender
`recipientFilter`	string	Filter by recipient address (useful with catch-all domains)

Response schema

Field	Type	Description
`to`req	string	Recipient address
`from`req	string	Sender address
`link`req	string	First body match — the link to follow
`mailbox`req	string	Which mailbox the hit came from. A link found in Spam is still a valid link, but it tells the caller the provider is filtering this sender.
`subject`req	string	Email subject line
`allLinks`req	array	Every distinct match in the body, in document order
`elapsedMs`req	integer
`fetchedAt`req	string
`receivedAt`req	string	When the email was received

Try it

imapPassrequired

IMAP password or app password

imapUserrequired

IMAP username (email address)

senderFilterrequired

Filter emails by sender (e.g. noreply@reddit.com)

imapHostoptional· default: imap.gmail.com

IMAP server hostname

imapPortoptional· default: 993

IMAP server port

mailboxesoptional

Mailboxes to search, in order. Omit to search INBOX plus whatever the server flags \All and \Junk (Gmail: All Mail and Spam) — providers routinely file one-time verification links as junk, and searching INBOX alone reports them as never sent.

maxRetriesoptional· default: 5

Number of polling attempts

linkPatternoptional· default: https?://[^\s"'<>)\]]+

Regex matched against the DECODED body. The first capture group is returned when present, otherwise the whole match. Default matches any http(s) URL.

retryDelayMsoptional· default: 10000

Milliseconds between retry attempts

maxAgeMinutesoptional· default: 15

Only look at emails received within this many minutes

subjectPatternoptional

Regex matched against the subject, to pick one of several mails from the same sender

recipientFilteroptional

Filter by recipient address (useful with catch-all domains)

Run this endpoint live

Jump in as a guest — no signup — and run email-read-verification-link.post with your own inputs. Create a free account anytime to get your own API key.

Code examples

curl -X POST https://api.upapi.io/email-read-verification-link.post \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "imapHost": "imap.gmail.com", "imapPass": "example", "imapPort": 993, "imapUser": "example", "maxRetries": 5, "linkPattern": "https?://[^\\s\"'\''<>)\\]]+", "retryDelayMs": 10000, "senderFilter": "noreply@reddit.com", "maxAgeMinutes": 15 }'

Developer tools

OpenAPI specImport the spec or collection into Postman, Insomnia, or any codegen tool.