LeadMagicHelp Center
Home
Troubleshooting
Integration Troubleshooting
Troubleshooting
Updated 1 week ago
6 min read

Integration Troubleshooting

This guide helps you diagnose and resolve common issues with LeadMagic integrations, with a special focus on Clay and other GTM tools.

Clay Integration Issues 🧩

Problem: LeadMagic Enrichment Not Running in Clay ❌

Potential Causes:

  1. API key issues
  2. Insufficient credits
  3. Incorrect input data
  4. Rate limiting

Troubleshooting Steps:

1. Verify API Key 🔑

  • Check that your LeadMagic API key is correctly entered in Clay
  • If using Clay-managed credits, verify you have sufficient Clay credits
  • Try regenerating your API key in LeadMagic and updating it in Clay

2. Check Input Data 📋

  • Ensure required fields are properly formatted:
    • Email addresses should be standard format (name@domain.com)
    • LinkedIn URLs should be complete (https://www.linkedin.com/in/username)
    • Company domains should not include http:// or www

3. Inspect Error Messages ⚠️

  • Check the error message in Clay's enrichment logs
  • Look for specific error codes and refer to their meaning below

4. Rate Limit Issues ⏱️

  • If processing large batches, try limiting concurrent requests
  • Add delays between enrichments using Clay's Formula functions

Clay Formula Tip

To add a delay between enrichments in Clay, you can use the sleep() function in a formula:

// Add a 2-second delay between enrichments
if(rowIndex() % 10 == 0) {
  sleep(2000)
  return true
} else {
  return true
}

Problem: Missing or Incomplete Data in Clay Results ❓

Potential Causes:

  1. Data not available in LeadMagic's database
  2. Conditional field mapping issues
  3. Incorrect data selection during setup

Troubleshooting Steps:

1. Verify Data Availability 🔍

  • Test the same search directly in LeadMagic to confirm data availability
  • Try alternative identifiers (email instead of LinkedIn URL, etc.)

2. Check Field Mapping 🗺️

  • Review which fields you selected during the enrichment setup
  • Ensure you've mapped all necessary fields to your Clay table

3. Data Formatting Issues 📝

  • Look for truncated or improperly formatted data
  • Check for character encoding issues with international data

Common Error Codes and Solutions 🛠️

Error CodeDescriptionSolution
`401`UnauthorizedYour API key is invalid or missing. Regenerate and update it.
`402`Payment RequiredYou've run out of credits. Purchase additional credits.
`403`ForbiddenYour account lacks permission for this action. Check your subscription plan.
`429`Too Many RequestsYou've exceeded rate limits. Implement delays between requests.
`500`Server ErrorTemporary issue on our end. Wait a few minutes and retry.

Webhook Integration Issues 🪝

Problem: Webhook Not Receiving Data ❌

Troubleshooting Steps:

1. Verify Webhook Configuration 🔧

  • Ensure your webhook URL is correctly entered
  • Check that your webhook endpoint is publicly accessible
  • Verify your server is properly handling POST requests

2. Inspect Webhook Logs 📋

  • Check LeadMagic webhook delivery logs in your account
  • Review server logs for incoming webhook requests
  • Look for any SSL/TLS certificate issues

3. Test with Webhook Debugger 🧪

  • Use a tool like RequestBin or Webhook.site to debug delivery
  • Set up a temporary webhook endpoint for testing

Security Note

Ensure your webhook endpoint is properly secured. We recommend using webhook signatures to verify that incoming requests are genuinely from LeadMagic.

Salesforce Integration Issues 🔄

Problem: Data Not Syncing to Salesforce ❌

Troubleshooting Steps:

1. Check Authentication 🔑

  • Verify your Salesforce connection is active
  • Check if tokens need to be refreshed

2. Review Field Mapping 🗺️

  • Ensure LeadMagic fields are correctly mapped to Salesforce fields
  • Check for any required fields that might be missing

3. Examine Salesforce Logs 📋

  • Look for API errors in Salesforce Setup > Logs
  • Check for validation rules or triggers blocking data entry

General Integration Debugging Tips 💡

  1. Start Small: Test with a single record before processing large batches
  2. Isolate Variables: Change one setting at a time to identify the issue
  3. Check Formatting: Ensure inputs match the expected format exactly
  4. Monitor API Usage: Watch for rate limit or credit consumption issues
  5. Review Recent Changes: Consider if recent updates to either system might be causing conflicts

Getting Advanced Support 🆘

If you're still experiencing integration issues:

1. Prepare Key Information 📋

  • Your LeadMagic account email
  • Integration type and configuration details
  • Specific error messages (screenshots are helpful)
  • Steps you've already taken to troubleshoot

2. Contact Support Channels 📞

3. Schedule Integration Consultation 📅

For complex integration scenarios, you can book a dedicated support session with our integration specialists here.

Preventative Measures 🛡️

To avoid future integration issues:

  1. Implement proper error handling in your integration code
  2. Set up monitoring for API usage and credit consumption
  3. Create fallback procedures for when enrichment services are unavailable
  4. Maintain an up-to-date backup of your most critical enriched data
  5. Stay informed about updates to both LeadMagic and your integrated platforms

Need Personalized Help?

Our integration specialists are ready to assist with your specific issues. Contact us at integration-support@leadmagic.io or schedule a consultation call.

Previous: Data Quality TroubleshootingNext: Frequently Asked Questions