{
  "service": "mailbox_validator",
  "displayName": "MailboxValidator",
  "categories": [
    "Communication",
    "Marketing"
  ],
  "authTypes": [
    "api_key"
  ],
  "auth": [
    {
      "type": "api_key",
      "label": "API Key",
      "placeholder": "MAILBOX_VALIDATOR_API_KEY",
      "description": "MailboxValidator sends your API key as the key query parameter. Get it from the MailboxValidator dashboard: https://www.mailboxvalidator.com/dashboard."
    }
  ],
  "homepageUrl": "https://www.mailboxvalidator.com",
  "actions": [
    {
      "id": "mailbox_validator.check_disposable_email",
      "service": "mailbox_validator",
      "name": "check_disposable_email",
      "description": "Check whether an email address belongs to a disposable email provider.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "description": "The email address to check.",
            "format": "email"
          }
        },
        "additionalProperties": false,
        "required": [
          "email"
        ],
        "description": "Input parameters for checking a disposable email address."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "email_address": {
            "type": "string",
            "description": "The input email address returned by MailboxValidator."
          },
          "is_disposable": {
            "type": "boolean",
            "description": "Whether the email address is from a disposable email provider."
          },
          "credits_available": {
            "type": "integer",
            "description": "Number of API credits currently available."
          }
        },
        "additionalProperties": false,
        "required": [
          "email_address",
          "is_disposable",
          "credits_available"
        ],
        "description": "MailboxValidator disposable email result."
      }
    },
    {
      "id": "mailbox_validator.check_free_email",
      "service": "mailbox_validator",
      "name": "check_free_email",
      "description": "Check whether an email address belongs to a free email provider.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "description": "The email address to check.",
            "format": "email"
          }
        },
        "additionalProperties": false,
        "required": [
          "email"
        ],
        "description": "Input parameters for checking a free email provider."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "email_address": {
            "type": "string",
            "description": "The input email address returned by MailboxValidator."
          },
          "is_free": {
            "type": "boolean",
            "description": "Whether the email address is from a free email provider."
          },
          "credits_available": {
            "type": "integer",
            "description": "Number of API credits currently available."
          }
        },
        "additionalProperties": false,
        "required": [
          "email_address",
          "is_free",
          "credits_available"
        ],
        "description": "MailboxValidator free email provider result."
      }
    },
    {
      "id": "mailbox_validator.validate_email",
      "service": "mailbox_validator",
      "name": "validate_email",
      "description": "Validate a single email address and return MailboxValidator deliverability signals.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "description": "The email address to check.",
            "format": "email"
          }
        },
        "additionalProperties": false,
        "required": [
          "email"
        ],
        "description": "Input parameters for validating one email address."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "email_address": {
            "type": "string",
            "description": "The input email address returned by MailboxValidator."
          },
          "base_email_address": {
            "type": "string",
            "description": "The sanitized base email address returned by MailboxValidator."
          },
          "domain": {
            "type": "string",
            "description": "The email domain returned by MailboxValidator."
          },
          "is_free": {
            "anyOf": [
              {
                "type": "boolean",
                "description": "MailboxValidator boolean signal, or null when the check is not applicable."
              },
              {
                "type": "null"
              }
            ]
          },
          "is_syntax": {
            "type": "boolean",
            "description": "Whether the email address syntax is valid."
          },
          "is_domain": {
            "anyOf": [
              {
                "type": "boolean",
                "description": "MailboxValidator boolean signal, or null when the check is not applicable."
              },
              {
                "type": "null"
              }
            ]
          },
          "is_smtp": {
            "anyOf": [
              {
                "type": "boolean",
                "description": "MailboxValidator boolean signal, or null when the check is not applicable."
              },
              {
                "type": "null"
              }
            ]
          },
          "is_verified": {
            "anyOf": [
              {
                "type": "boolean",
                "description": "MailboxValidator boolean signal, or null when the check is not applicable."
              },
              {
                "type": "null"
              }
            ]
          },
          "is_server_down": {
            "anyOf": [
              {
                "type": "boolean",
                "description": "MailboxValidator boolean signal, or null when the check is not applicable."
              },
              {
                "type": "null"
              }
            ]
          },
          "is_greylisted": {
            "anyOf": [
              {
                "type": "boolean",
                "description": "MailboxValidator boolean signal, or null when the check is not applicable."
              },
              {
                "type": "null"
              }
            ]
          },
          "is_disposable": {
            "anyOf": [
              {
                "type": "boolean",
                "description": "MailboxValidator boolean signal, or null when the check is not applicable."
              },
              {
                "type": "null"
              }
            ]
          },
          "is_suppressed": {
            "anyOf": [
              {
                "type": "boolean",
                "description": "MailboxValidator boolean signal, or null when the check is not applicable."
              },
              {
                "type": "null"
              }
            ]
          },
          "is_role": {
            "anyOf": [
              {
                "type": "boolean",
                "description": "MailboxValidator boolean signal, or null when the check is not applicable."
              },
              {
                "type": "null"
              }
            ]
          },
          "is_high_risk": {
            "anyOf": [
              {
                "type": "boolean",
                "description": "MailboxValidator boolean signal, or null when the check is not applicable."
              },
              {
                "type": "null"
              }
            ]
          },
          "is_catchall": {
            "anyOf": [
              {
                "type": "boolean",
                "description": "MailboxValidator boolean signal, or null when the check is not applicable."
              },
              {
                "type": "null"
              }
            ]
          },
          "is_dmarc_enforced": {
            "type": "boolean",
            "description": "Whether the email domain enforces DMARC."
          },
          "is_strict_spf": {
            "type": "boolean",
            "description": "Whether the email domain uses strict SPF."
          },
          "website_exist": {
            "type": "boolean",
            "description": "Whether the email domain has a reachable website."
          },
          "mailboxvalidator_score": {
            "type": "number",
            "description": "MailboxValidator reputation score for the email address."
          },
          "time_taken": {
            "type": "number",
            "description": "Time taken by MailboxValidator to produce the result, in seconds."
          },
          "status": {
            "type": "boolean",
            "description": "Whether MailboxValidator considers the email address valid."
          },
          "credits_available": {
            "type": "integer",
            "description": "Number of validation credits currently available."
          }
        },
        "additionalProperties": false,
        "required": [
          "email_address"
        ],
        "description": "MailboxValidator single email validation result."
      }
    }
  ]
}