Keep unwanted senders out of your agents' inboxes and phone numbers. Inkbox combines a mode — whitelist or blacklist — with a list of contact rules to decide whether inbound email, calls, and texts are delivered. The concept is identical on both channels; the only differences are what match_target can contain.

Every mailbox and every phone number has a filter_mode field with two values:

• blacklist (default). Everything is delivered unless a block rule matches the sender.
• whitelist. Nothing is delivered unless an allow rule matches the sender.

Mail rules match on exact_email (e.g. jane@acme.example) or domain (e.g. acme.example). Phone rules match on exact_number — an E.164 phone number. Rules carry an action (allow or block) and a status (active, paused, or deleted) — paused rules reserve the target slot without taking effect, which is useful for staging policy changes.

Most agents start in blacklist mode: accept everyone, add explicit blocks for spam domains or individual bad actors. Switch a mailbox or number to whitelist when you want the opposite — locked down by default, with a known allowlist.

Flip the mode on the mailbox or phone number resource itself:

Create allow or block rules scoped to a specific mailbox. Match on an exact email address or a domain (every address at acme.example).

Create allow or block rules scoped to a specific phone number. match_type must be exact_number, and match_target is an E.164 phone number.

Flip a rule from active to paused when you want to disable it without losing the uniqueness claim on the (match_type, match_target) slot. Reactivate by setting status back to active. Use DELETE to remove the rule entirely.

List the rules on a single mailbox or phone number, or use the admin-only list_all methods to pull every rule in the organization — handy for compliance reviews or answering "is this sender blocked anywhere".

• Mailbox contact rules API
• Phone contact rules API
• Mailboxes API — where filter_mode lives for mail
• Phone numbers API — where filter_mode lives for phone