Get Mailbox Deliverability
get_mailbox_deliverabilityCall this when the user asks why their emails land in spam or the junk folder, or before launching a campaign to confirm the sending mailbox is configured to deliver. Each mailbox reflects the last DNS check — Sliq re-checks daily and on connect, so the data is current without asking the user to re-run it.
verdict is the worst of the four record statuses: 'fail' (a record is
misconfigured and may block or junk sends, so is_send_ready is False),
'warn' (advisory — delivery still works), or 'pass' (all four clean). score
is a 0-100 roll-up that score_tier buckets into 'good' / 'needs_work' /
'critical'. Each checks entry carries the per-record diagnostic (what is
wrong) and fix_instruction_markdown (how to fix it, null when that record
passes) — relay these when the user wants to fix a failing record. A
mailbox's deliverability is None when it has never been checked — tell the
user to open that mailbox in Settings and run the DNS check. An empty
mailboxes list means no email account is connected.
{
'mailboxes': [
{
'email': str, 'provider': str, 'is_default': bool,
'deliverability': {
'domain': str,
'verdict': 'pass' | 'warn' | 'fail',
'score': int,
'score_tier': 'good' | 'needs_work' | 'critical',
'is_send_ready': bool,
'last_checked_at': str, # ISO 8601
'dns_provider': str,
'checks': [
{'record_type': 'spf' | 'dkim' | 'dmarc' | 'mx',
'status': 'pass' | 'warn' | 'fail',
'raw_record': str, 'diagnostic': str,
'fix_instruction_markdown': str | None},
...
],
},
},
...
],
}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||