Mailgun Optimize (InboxReady)

Overview

Mailgun Optimize (by Sinch), formerly InboxReady, is a deliverability suite: inbox placement testing via seed lists, IP and domain blocklist monitoring, spam trap tracking, email health scoring, DMARC reporting, Google Postmaster Tools integration, and Microsoft SNDS data.

Agent Instructions

Before generating code, gather from the user (skip any item already specified in the prompt or context):

1. Region — US or EU? Region determines the base URL.
2. Language — any language, or curl. This API is REST-only; there is no SDK wrapper.
3. Before generating code, check for existing .env files or environment variables for MAILGUN_API_KEY.

Product gotchas to apply unconditionally:

• Domain registration uses a query param, not a JSON body — POST /v1/inboxready/domains?domain=example.com.
• For inbox placement, create a test via POST /v4/inbox/tests with html or template_name. The response includes a result_id — poll GET /v4/inbox/results/{result_id} for results.
• Use /v2/spamtraps (current). The /v1/spamtraps endpoint is deprecated.