> ## Documentation Index
> Fetch the complete documentation index at: https://leadmagic.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Support & Policies

> Get help, understand our policies, and contact the LeadMagic team

At LeadMagic, we're committed to helping you succeed with our API. Whether you have a question, encounter an issue, or need guidance, our support team is here to help.

## Contact Options

> [card] [Email Support](mailto:support@leadmagic.io)
>
> **[support@leadmagic.io](mailto:support@leadmagic.io)**
>
> Available 9 AM - 5 PM EST. Response within 24 hours.

> [card] Live Chat
>
> **In-App Chat**
>
> Click the chat icon in the bottom right of your dashboard for immediate assistance.

> [card] [Help Center](https://help.leadmagic.io/en)
>
> **Self-Service Help**
>
> Browse articles, tutorials, and FAQs.

> [card] [Sales Inquiries](mailto:support@leadmagic.io)
>
> **Enterprise & Custom Plans**
>
> Contact our team for custom solutions.

## Help Center Resources

> [accordion] Getting Started
>
> * [Welcome to LeadMagic](https://help.leadmagic.io/en) - Platform overview
> * [Creating Your Account](https://help.leadmagic.io/en) - Account setup guide
> * [The LeadMagic Credit System](https://leadmagic.io/docs/v1/credits.md) - Understanding credits
> * [Subscription Plans](https://leadmagic.io/docs/v1/credits.md#subscription-plans) - Plan comparison

> [accordion] List Data Enrichment
>
> * [Uploading a List for Enrichment](https://help.leadmagic.io/en) - Bulk processing
> * [Email Validation](https://leadmagic.io/docs/v1/reference/email-validation.md) - Verify email addresses
> * [Email Finder](https://leadmagic.io/docs/v1/reference/email-finder.md) - Find work emails
> * [Mobile Finder](https://leadmagic.io/docs/v1/reference/mobile-finder.md) - Find mobile numbers
> * [Profile Search](https://leadmagic.io/docs/v1/reference/profile-search.md) - Enrich LinkedIn profiles
> * [Company Search](https://leadmagic.io/docs/v1/reference/company-search.md) - Company data enrichment

> [accordion] API Usage
>
> * [Authentication](https://leadmagic.io/docs/v1/authentication.md) - API key setup
> * [Making API Calls](https://leadmagic.io/docs/v1/making-api-calls.md) - Request & response formats
> * [Check Credits](https://leadmagic.io/docs/v1/reference/check-credits.md) - Monitor your balance
> * [Integrations](https://leadmagic.io/docs/v1/integrations.md) - Third-party platform guides

> [accordion] Account Management
>
> * [Team Management](https://leadmagic.io/docs/v1/credits.md#team-credit-management) - Share credits with team
> * [Billing & Invoices](https://leadmagic.io/docs/v1/credits.md#billing--payments) - Payment management
> * [API Keys](https://app.leadmagic.io/settings/api) - Key management

## Before Contacting Support

> [!NOTE]
>
> Check these resources first - your answer might already be available!

> [accordion] Search the Documentation
>
> Use the search bar at the top of this page to find answers to common questions.

> [accordion] Check Your API Response
>
> Error messages often contain helpful information about what went wrong.
> Check the `errors` array and `meta.request_id` in your API response.

> [accordion] Verify Your API Key
>
> Ensure your API key is correct and hasn't expired. You can regenerate it in
> your [account settings](https://app.leadmagic.io/settings/api).

> [accordion] Check Your Credit Balance
>
> Use the [Check Credits endpoint](https://leadmagic.io/docs/v1/reference/check-credits.md) to verify you
> have sufficient credits.

## How to Report an Issue

When contacting support, please include:

**1. Describe the issue**

Explain what you're trying to do and what's not working as expected.

**2. Include your API key prefix**

Share the **first 8 characters** of your API key for identification.

> [!WARNING]
>
> Never share your full API key. Only the first 8 characters.

**3. Provide the request details**

Include the endpoint URL, request body (with sensitive data redacted), and
any error messages.

**4. Share the response**

Include the full API response, including status code and error details.

### Example Support Request

> [accordion] Good support request example
>
> ```markdown theme={"theme":{"light":"github-light","dark":"github-dark"}}
> **Issue:** Email validation returning "unknown" for valid emails
>
> **API Key Prefix:** abc12345...
>
> **Endpoint:** POST /v1/people/email-validation
>
> **Request Body:**
> {
>   "email": "alex.rivera@example.com"
> }
>
> **Response:**
> {
>   "status": "unknown",
>   "email": "alex.rivera@example.com"
> }
>
> **Expected:** Status should be "valid" as the email exists.
>
> **Environment:** Node.js 20, using fetch API
> ```

## Common Issues

> [accordion] 401 Unauthorized
>
> **Cause:** Invalid or missing API key.
>
> **Solution:**
>
> * Verify your API key in the dashboard
> * Check the header name is exactly `X-API-Key`
> * Ensure there are no extra spaces in the key

> [accordion] 402 Payment Required
>
> **Cause:** Insufficient credits in your account.
>
> **Solution:**
>
> * Check your balance in the dashboard
> * Purchase additional credits
> * Use the [Check Credits endpoint](https://leadmagic.io/docs/v1/reference/check-credits.md)

> [accordion] 429 Too Many Requests
>
> **Cause:** Rate limit exceeded.
>
> **Solution:**
>
> * Reduce your request frequency
> * Implement exponential backoff
> * Contact us for higher limits

> [accordion] Unknown email results
>
> **Cause:** The mail server didn't respond or the domain is unverifiable.
>
> **Solution:**
>
> * `unknown` results are free — you are not charged
> * Retry validation later, or use Email Finder to verify the address
> * See [Email Validation docs](https://leadmagic.io/docs/v1/reference/email-validation.md) for details

## Policies

* **Cancellation:** Cancel anytime under Settings > Billing. Access continues until end of billing cycle.
* **Refunds:** LeadMagic does not provide refunds. Contact [support@leadmagic.io](mailto:support@leadmagic.io) with billing concerns.
* **Data:** We don't store enriched data. All API traffic is encrypted via TLS 1.3.

> [!TIP]
>
> See our [Privacy Policy](https://leadmagic.io/legal/privacy) and [Terms of Service](https://leadmagic.io/legal/terms) for full details.

## Enterprise Support

> [!NOTE]
>
> Enterprise customers receive priority support with dedicated account management.

> [card] Priority Response
>
> Get responses within 2 hours during business hours.

> [card] Dedicated Slack Channel
>
> Direct communication with our engineering team.

> [card] Custom Rate Limits
>
> Higher rate limits tailored to your needs.

> [card] Onboarding Support
>
> Personalized setup and integration assistance.

> [!TIP]
>
> Interested in enterprise support? [Contact us](mailto:support@leadmagic.io) to learn more.

## Feedback

We continuously improve our API and documentation based on your feedback.

> [card] [Feature Requests](mailto:feedback@leadmagic.io)
>
> Have an idea for a new feature? We'd love to hear it.

> [card] [Report a Bug](mailto:support@leadmagic.io)
>
> Found an issue? Let us know and we'll fix it ASAP.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.