{
  "service": "leadmagic",
  "displayName": "LeadMagic",
  "categories": [
    "Marketing",
    "Data"
  ],
  "authTypes": [
    "api_key"
  ],
  "auth": [
    {
      "type": "api_key",
      "label": "API Key",
      "placeholder": "LEADMAGIC_API_KEY",
      "description": "LeadMagic API key used with the X-API-Key header. Create or view it in LeadMagic account settings: https://app.leadmagic.io/settings/api."
    }
  ],
  "homepageUrl": "https://leadmagic.io",
  "actions": [
    {
      "id": "leadmagic.enrich_company",
      "service": "leadmagic",
      "name": "enrich_company",
      "description": "Find and enrich company data by domain, profile URL, or company name.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "companyDomain": {
            "type": "string",
            "minLength": 1,
            "description": "The company website domain to enrich, such as example.com."
          },
          "profileUrl": {
            "type": "string",
            "minLength": 1,
            "description": "The professional company profile URL or slug."
          },
          "companyName": {
            "type": "string",
            "minLength": 1,
            "description": "The company name to enrich."
          }
        },
        "additionalProperties": false,
        "description": "Input for LeadMagic company enrichment.",
        "anyOf": [
          {
            "required": [
              "companyDomain"
            ]
          },
          {
            "required": [
              "profileUrl"
            ]
          },
          {
            "required": [
              "companyName"
            ]
          }
        ]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "companyName": {
            "anyOf": [
              {
                "type": "string",
                "description": "The official company name returned by LeadMagic."
              },
              {
                "type": "null"
              }
            ]
          },
          "companyId": {
            "anyOf": [
              {
                "type": "integer",
                "description": "The LeadMagic company identifier."
              },
              {
                "type": "null"
              }
            ]
          },
          "industry": {
            "anyOf": [
              {
                "type": "string",
                "description": "The company's primary industry."
              },
              {
                "type": "null"
              }
            ]
          },
          "employeeCount": {
            "anyOf": [
              {
                "type": "integer",
                "description": "The exact employee count when returned by LeadMagic."
              },
              {
                "type": "null"
              }
            ]
          },
          "employeeRange": {
            "anyOf": [
              {
                "type": "string",
                "description": "The employee count range returned by LeadMagic."
              },
              {
                "type": "null"
              }
            ]
          },
          "founded": {
            "anyOf": [
              {
                "type": "integer",
                "description": "The company's founding year."
              },
              {
                "type": "null"
              }
            ]
          },
          "headquarters": {
            "anyOf": [
              {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "The company headquarters location object."
              },
              {
                "type": "null"
              }
            ]
          },
          "revenue": {
            "anyOf": [
              {
                "type": "string",
                "description": "The company's annual revenue range."
              },
              {
                "type": "null"
              }
            ]
          },
          "funding": {
            "anyOf": [
              {
                "type": "string",
                "description": "The company's total funding value."
              },
              {
                "type": "null"
              }
            ]
          },
          "followerCount": {
            "anyOf": [
              {
                "type": "integer",
                "description": "The company's social follower count."
              },
              {
                "type": "null"
              }
            ]
          },
          "twitterUrl": {
            "anyOf": [
              {
                "type": "string",
                "description": "The company's Twitter or X profile URL."
              },
              {
                "type": "null"
              }
            ]
          },
          "facebookUrl": {
            "anyOf": [
              {
                "type": "string",
                "description": "The company's Facebook page URL."
              },
              {
                "type": "null"
              }
            ]
          },
          "b2bProfileUrl": {
            "anyOf": [
              {
                "type": "string",
                "description": "The company's professional profile URL."
              },
              {
                "type": "null"
              }
            ]
          },
          "logoUrl": {
            "anyOf": [
              {
                "type": "string",
                "description": "The company's logo URL."
              },
              {
                "type": "null"
              }
            ]
          },
          "description": {
            "anyOf": [
              {
                "type": "string",
                "description": "The company description."
              },
              {
                "type": "null"
              }
            ]
          },
          "specialties": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "One company specialty."
            },
            "description": "The company specialties returned by LeadMagic."
          },
          "competitors": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "One competitor name."
            },
            "description": "The competitor names returned by LeadMagic."
          },
          "raw": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The raw LeadMagic company enrichment payload."
          }
        },
        "additionalProperties": false,
        "description": "The normalized LeadMagic company enrichment response."
      }
    },
    {
      "id": "leadmagic.enrich_profile",
      "service": "leadmagic",
      "name": "enrich_profile",
      "description": "Retrieve professional profile data from a profile URL or username.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "profileUrl": {
            "type": "string",
            "minLength": 1,
            "description": "The professional profile URL or username to enrich."
          },
          "extendedResponse": {
            "type": "boolean",
            "description": "Whether to include extended profile fields such as image URL."
          }
        },
        "additionalProperties": false,
        "required": [
          "profileUrl"
        ],
        "description": "Input for LeadMagic profile enrichment."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "profileUrl": {
            "anyOf": [
              {
                "type": "string",
                "description": "The professional profile URL returned by LeadMagic."
              },
              {
                "type": "null"
              }
            ]
          },
          "firstName": {
            "anyOf": [
              {
                "type": "string",
                "description": "The person's first name."
              },
              {
                "type": "null"
              }
            ]
          },
          "lastName": {
            "anyOf": [
              {
                "type": "string",
                "description": "The person's last name."
              },
              {
                "type": "null"
              }
            ]
          },
          "fullName": {
            "anyOf": [
              {
                "type": "string",
                "description": "The person's full name."
              },
              {
                "type": "null"
              }
            ]
          },
          "professionalTitle": {
            "anyOf": [
              {
                "type": "string",
                "description": "The person's current professional title."
              },
              {
                "type": "null"
              }
            ]
          },
          "bio": {
            "anyOf": [
              {
                "type": "string",
                "description": "The person's profile summary."
              },
              {
                "type": "null"
              }
            ]
          },
          "location": {
            "anyOf": [
              {
                "type": "string",
                "description": "The person's geographic location."
              },
              {
                "type": "null"
              }
            ]
          },
          "country": {
            "anyOf": [
              {
                "type": "string",
                "description": "The person's country."
              },
              {
                "type": "null"
              }
            ]
          },
          "followersRange": {
            "anyOf": [
              {
                "type": "string",
                "description": "The person's social follower range."
              },
              {
                "type": "null"
              }
            ]
          },
          "companyName": {
            "anyOf": [
              {
                "type": "string",
                "description": "The person's current company name."
              },
              {
                "type": "null"
              }
            ]
          },
          "companyIndustry": {
            "anyOf": [
              {
                "type": "string",
                "description": "The person's current company industry."
              },
              {
                "type": "null"
              }
            ]
          },
          "companyWebsite": {
            "anyOf": [
              {
                "type": "string",
                "description": "The person's current company website."
              },
              {
                "type": "null"
              }
            ]
          },
          "totalTenureYears": {
            "anyOf": [
              {
                "type": "string",
                "description": "The person's total career tenure in years."
              },
              {
                "type": "null"
              }
            ]
          },
          "totalTenureMonths": {
            "anyOf": [
              {
                "type": "string",
                "description": "The person's total career tenure in months."
              },
              {
                "type": "null"
              }
            ]
          },
          "workExperience": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "One work history entry."
            },
            "description": "The work history entries returned by LeadMagic."
          },
          "education": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "One education entry."
            },
            "description": "The education entries returned by LeadMagic."
          },
          "certifications": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "One certification entry."
            },
            "description": "The certification entries returned by LeadMagic."
          },
          "raw": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The raw LeadMagic profile enrichment payload."
          }
        },
        "additionalProperties": false,
        "description": "The normalized LeadMagic profile enrichment response."
      }
    },
    {
      "id": "leadmagic.find_mobile",
      "service": "leadmagic",
      "name": "find_mobile",
      "description": "Find a mobile phone number from a profile URL or email identifier.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "profileUrl": {
            "type": "string",
            "minLength": 1,
            "description": "The professional profile URL or username to look up."
          },
          "workEmail": {
            "type": "string",
            "description": "The professional email address to improve matching.",
            "format": "email"
          },
          "personalEmail": {
            "type": "string",
            "description": "The personal email address to use as an alternative identifier.",
            "format": "email"
          }
        },
        "additionalProperties": false,
        "description": "Input for LeadMagic mobile finder.",
        "anyOf": [
          {
            "required": [
              "profileUrl"
            ]
          },
          {
            "required": [
              "workEmail"
            ]
          },
          {
            "required": [
              "personalEmail"
            ]
          }
        ]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "profileUrl": {
            "anyOf": [
              {
                "type": "string",
                "description": "The profile URL used for the mobile lookup."
              },
              {
                "type": "null"
              }
            ]
          },
          "email": {
            "anyOf": [
              {
                "type": "string",
                "description": "The email address used for the mobile lookup."
              },
              {
                "type": "null"
              }
            ]
          },
          "mobileNumber": {
            "anyOf": [
              {
                "type": "string",
                "description": "The mobile phone number found, or null when none was found."
              },
              {
                "type": "null"
              }
            ]
          },
          "creditsConsumed": {
            "anyOf": [
              {
                "type": "number",
                "description": "The credits consumed by this lookup."
              },
              {
                "type": "null"
              }
            ]
          },
          "message": {
            "anyOf": [
              {
                "type": "string",
                "description": "The human-readable LeadMagic result message."
              },
              {
                "type": "null"
              }
            ]
          },
          "raw": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The raw LeadMagic mobile finder payload."
          }
        },
        "additionalProperties": false,
        "description": "The normalized LeadMagic mobile finder response."
      }
    },
    {
      "id": "leadmagic.find_work_email",
      "service": "leadmagic",
      "name": "find_work_email",
      "description": "Find a professional email address from a person's name and company.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "firstName": {
            "type": "string",
            "minLength": 1,
            "description": "The person's first name. Required if fullName is not provided."
          },
          "lastName": {
            "type": "string",
            "minLength": 1,
            "description": "The person's last name. Required if fullName is not provided."
          },
          "fullName": {
            "type": "string",
            "minLength": 1,
            "description": "The person's full name as an alternative to firstName and lastName."
          },
          "domain": {
            "type": "string",
            "minLength": 1,
            "description": "The company website domain, such as example.com."
          },
          "companyName": {
            "type": "string",
            "minLength": 1,
            "description": "The company name when a domain is not available."
          }
        },
        "additionalProperties": false,
        "description": "Input for LeadMagic work email finder.",
        "allOf": [
          {
            "anyOf": [
              {
                "required": [
                  "fullName"
                ]
              },
              {
                "required": [
                  "firstName"
                ]
              },
              {
                "required": [
                  "lastName"
                ]
              }
            ]
          },
          {
            "anyOf": [
              {
                "required": [
                  "domain"
                ]
              },
              {
                "required": [
                  "companyName"
                ]
              }
            ]
          }
        ]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "email": {
            "anyOf": [
              {
                "type": "string",
                "description": "The found professional email address, or null when none was found."
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "anyOf": [
              {
                "type": "string",
                "description": "The LeadMagic result status, such as valid or null."
              },
              {
                "type": "null"
              }
            ]
          },
          "creditsConsumed": {
            "anyOf": [
              {
                "type": "number",
                "description": "The credits consumed by this lookup."
              },
              {
                "type": "null"
              }
            ]
          },
          "message": {
            "anyOf": [
              {
                "type": "string",
                "description": "The human-readable LeadMagic result message."
              },
              {
                "type": "null"
              }
            ]
          },
          "employmentVerified": {
            "anyOf": [
              {
                "type": "boolean",
                "description": "Whether employment at the company was verified."
              },
              {
                "type": "null"
              }
            ]
          },
          "mxRecord": {
            "anyOf": [
              {
                "type": "string",
                "description": "The primary MX record for the company domain."
              },
              {
                "type": "null"
              }
            ]
          },
          "mxProvider": {
            "anyOf": [
              {
                "type": "string",
                "description": "The email provider detected from MX records."
              },
              {
                "type": "null"
              }
            ]
          },
          "hasMx": {
            "anyOf": [
              {
                "type": "boolean",
                "description": "Whether the company domain has MX records."
              },
              {
                "type": "null"
              }
            ]
          },
          "company": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "Company enrichment fields returned with the email finder result."
          },
          "raw": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The raw LeadMagic work email finder payload."
          }
        },
        "additionalProperties": false,
        "description": "The normalized LeadMagic work email finder response."
      }
    },
    {
      "id": "leadmagic.get_credits",
      "service": "leadmagic",
      "name": "get_credits",
      "description": "Get the current LeadMagic credit balance for the API key.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false,
        "description": "No input is required for LeadMagic credit balance lookup."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "credits": {
            "type": "number",
            "description": "The current LeadMagic credit balance."
          },
          "raw": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The raw LeadMagic credit balance payload."
          }
        },
        "additionalProperties": false,
        "description": "The LeadMagic credit balance response."
      }
    },
    {
      "id": "leadmagic.validate_email",
      "service": "leadmagic",
      "name": "validate_email",
      "description": "Validate an email address for deliverability and domain intelligence.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "description": "The email address to validate.",
            "format": "email"
          }
        },
        "additionalProperties": false,
        "description": "Input for LeadMagic email validation."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "email": {
            "anyOf": [
              {
                "type": "string",
                "description": "The normalized email address returned by LeadMagic."
              },
              {
                "type": "null"
              }
            ]
          },
          "emailStatus": {
            "anyOf": [
              {
                "type": "string",
                "description": "The validation status, such as valid, invalid, or unknown."
              },
              {
                "type": "null"
              }
            ]
          },
          "isDomainCatchAll": {
            "anyOf": [
              {
                "type": "boolean",
                "description": "Whether LeadMagic detected an accept-all domain."
              },
              {
                "type": "null"
              }
            ]
          },
          "creditsConsumed": {
            "anyOf": [
              {
                "type": "number",
                "description": "The credits consumed by this validation request."
              },
              {
                "type": "null"
              }
            ]
          },
          "message": {
            "anyOf": [
              {
                "type": "string",
                "description": "The human-readable LeadMagic validation message."
              },
              {
                "type": "null"
              }
            ]
          },
          "mxRecord": {
            "anyOf": [
              {
                "type": "string",
                "description": "The primary MX record for the email domain."
              },
              {
                "type": "null"
              }
            ]
          },
          "mxProvider": {
            "anyOf": [
              {
                "type": "string",
                "description": "The email provider detected from MX records."
              },
              {
                "type": "null"
              }
            ]
          },
          "mxGateway": {
            "anyOf": [
              {
                "type": "string",
                "description": "The MX security gateway vendor when available."
              },
              {
                "type": "null"
              }
            ]
          },
          "mxGatewayType": {
            "anyOf": [
              {
                "type": "string",
                "description": "The MX security gateway type when available."
              },
              {
                "type": "null"
              }
            ]
          },
          "mxSecurityGateway": {
            "anyOf": [
              {
                "type": "boolean",
                "description": "Whether a security gateway is present."
              },
              {
                "type": "null"
              }
            ]
          },
          "company": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "Company enrichment fields returned with the validation result."
          },
          "raw": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The raw LeadMagic email validation payload."
          }
        },
        "additionalProperties": false,
        "description": "The normalized LeadMagic email validation response."
      }
    }
  ]
}