{
  "service": "kickbox",
  "displayName": "Kickbox",
  "categories": [
    "Communication",
    "Marketing"
  ],
  "authTypes": [
    "api_key"
  ],
  "auth": [
    {
      "type": "api_key",
      "label": "API Key",
      "placeholder": "KICKBOX_API_KEY",
      "description": "Kickbox API key passed with the apikey query parameter. Find it on the account keys settings page: https://app.kickbox.com/accounts/<accountId>/settings/keys"
    }
  ],
  "homepageUrl": "https://kickbox.com/",
  "actions": [
    {
      "id": "kickbox.check_disposable_email",
      "service": "kickbox",
      "name": "check_disposable_email",
      "description": "Check whether an email address or domain belongs to a disposable email provider.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "domain_or_email": {
            "type": "string",
            "minLength": 1,
            "description": "The email address or domain to check for disposable-email status."
          }
        },
        "additionalProperties": false,
        "description": "The input payload for checking whether an email or domain is disposable."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "disposable": {
            "type": "boolean",
            "description": "Whether the input email address or domain belongs to a disposable provider."
          }
        },
        "additionalProperties": false,
        "description": "The disposable-email lookup result returned by Kickbox."
      }
    },
    {
      "id": "kickbox.verify_email",
      "service": "kickbox",
      "name": "verify_email",
      "description": "Verify whether a single email address is deliverable and retrieve Kickbox risk signals.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "description": "The email address to verify.",
            "format": "email"
          }
        },
        "additionalProperties": false,
        "description": "The input payload for verifying a single email address with Kickbox."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "result": {
            "type": "string",
            "enum": [
              "deliverable",
              "undeliverable",
              "risky",
              "unknown"
            ],
            "description": "The overall verification result returned by Kickbox."
          },
          "reason": {
            "type": "string",
            "description": "The provider reason that explains the verification result."
          },
          "role": {
            "type": "boolean",
            "description": "Whether the address is role-based, such as support@ or admin@."
          },
          "free": {
            "type": "boolean",
            "description": "Whether the address belongs to a free email provider."
          },
          "disposable": {
            "type": "boolean",
            "description": "Whether the address belongs to a disposable email provider."
          },
          "accept_all": {
            "type": "boolean",
            "description": "Whether the domain appears to accept all inbound email addresses."
          },
          "sendex": {
            "type": "number",
            "description": "Kickbox Sendex quality score between 0 and 1."
          },
          "email": {
            "type": "string",
            "description": "The normalized email address evaluated by Kickbox."
          },
          "success": {
            "type": "boolean",
            "description": "Whether Kickbox completed the verification request successfully."
          },
          "user": {
            "type": "string",
            "description": "The local part of the verified email address."
          },
          "domain": {
            "type": "string",
            "description": "The domain part of the verified email address."
          },
          "did_you_mean": {
            "type": "string",
            "description": "Suggested corrected email address when Kickbox detects a likely typo."
          }
        },
        "additionalProperties": false,
        "required": [
          "result",
          "reason",
          "role",
          "free",
          "disposable",
          "accept_all",
          "sendex",
          "email",
          "success"
        ],
        "description": "The single-email verification result returned by Kickbox."
      }
    }
  ]
}
