canonical: https://jentic.com/apis/enrichley.io/enrichley # Enrichley API Enrichley provides email validation and LinkedIn profile enrichment for B2B sales and marketing workflows. The API exposes a focused three-endpoint surface: validate a single email address, look up the authenticated account, and enrich a LinkedIn profile URL into a structured contact record. It is designed for outbound prospecting and lead-qualification pipelines that need a lightweight enrichment step before importing contacts into a CRM or outreach tool. ## For AI agents Validate email deliverability and enrich LinkedIn profile URLs into structured contact records for B2B prospecting workflows. ## Scope Does not handle company-level firmographics, phone enrichment, or sending outbound emails - use for single-email validation and LinkedIn profile enrichment only. ## Capabilities - Validate that a single email address is deliverable before sending or importing it - Enrich a LinkedIn profile URL into a structured contact record with name, role, and company - Look up the authenticated Enrichley account via /me to verify quota and key scope - Use Enrichley enrichment to qualify outbound prospect lists before CRM import - Combine email validation and profile enrichment to score lead quality ## Use cases ### Outbound Email List Hygiene Before sending an outbound campaign, validate every captured email address with POST /validate-single-email so undeliverable and risky addresses are filtered out. Keeping bounce rates low protects the sending domain's reputation and lifts inbox placement, which is critical for cold outreach. The check takes a few hundred milliseconds per address. Example prompt: Call POST /validate-single-email for 'jane@acme.com' and reject the contact if the response status is not 'deliverable'. ### LinkedIn URL to CRM Contact Convert a LinkedIn profile URL collected from a chat or scrape into a structured contact via POST /profile-enrichment, then write the resulting name, title, and company into the CRM. This removes the manual copy-paste step that slows down sales development reps and standardises records before import. Example prompt: Call POST /profile-enrichment with linkedin_url 'https://linkedin.com/in/jane-doe' and save the returned name, title, and company to the CRM contact. ### Quota and Account Health Monitoring Operations teams call GET /me on a schedule to monitor remaining Enrichley credit and confirm the API key is still active. Surfacing the balance in an internal dashboard prevents campaign failures caused by exhausted quota. The endpoint is also useful as a health check during deployment. Example prompt: Call GET /me and emit a warning to the ops channel if remaining credit is below 1,000. ### AI Agent Sales Qualification Through Jentic An AI sales agent uses Jentic to qualify inbound LinkedIn URLs and emails by chaining Enrichley's profile enrichment and email validation. The Enrichley API key is held in your Jentic One instance and never enters the agent's prompt. The agent attaches the validated contact to the CRM record automatically. Example prompt: Search Jentic for 'enrich a LinkedIn profile', load POST /profile-enrichment, and execute it for the captured LinkedIn URL. ## Key endpoints | Method | Path | Description | | --- | --- | --- | | POST | `/validate-single-email` | Validate the deliverability of an email address | | POST | `/profile-enrichment` | Enrich a LinkedIn profile URL into a contact record | | GET | `/me` | Return the authenticated account and quota information | ## Key resources - **Email Validation** — Validate the deliverability of a single email address via POST /validate-single-email. - **Enrichment** — Enrich a LinkedIn profile URL into a structured contact via POST /profile-enrichment. - **Account** — Inspect the authenticated account and remaining quota via GET /me. ## Why Jentic - **Setup:** Wiring Enrichley by hand means handling its API-key request header auth and building your own retry handling against api.enrichley.io for the validation and enrichment calls. Through Jentic you install once, import the Enrichley API from the API Directory, store the API key once, and your agent calls it. - **Permission scoping:** Enrichley sends the email or profile to check in the request body rather than the URL, so scope the agent to the operations it needs, such as POST /validate-single-email or POST /profile-enrichment. You pick that allowed set, so an operation is only reachable if you include it. - **Credential handling:** Your Enrichley API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'validate an email address' or 'enrich a LinkedIn profile', and Jentic returns the matching Enrichley operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Hunter** — Email finding and verification with broader domain-search features - **NeverBounce** — High-volume email verification specialist - **HubSpot** — Write enriched and validated contacts straight into the CRM ## FAQ ### What authentication does the Enrichley API use? The Enrichley API uses an API key passed in the X-API-Key header on every request. Through Jentic, the key is stored in your Jentic One instance and injected at execution time so it never enters the agent context. ### Can I validate an email address with the Enrichley API? Yes. POST /validate-single-email checks deliverability for a single address and returns a status. Use it to filter outbound lists before sending to protect domain reputation. ### How does Enrichley enrich a LinkedIn profile? POST /profile-enrichment accepts a LinkedIn profile URL and returns a structured contact record including name, role, and company information that can be written directly into a CRM. ### What are the rate limits for the Enrichley API? The OpenAPI spec does not publish numeric rate limits. Enrichley enforces credit-based usage tied to the account plan; check remaining balance with GET /me and contact Enrichley if you need higher throughput. ### How do I check my Enrichley credit balance through Jentic? Search Jentic for 'check Enrichley account info', load the GET /me operation, and execute it to read the remaining credit. Get started with Jentic One, the self-hosted execution layer. ### Does Enrichley support bulk email validation? The published OpenAPI spec exposes only single-email validation via POST /validate-single-email. For bulk lists, call the endpoint per address with appropriate concurrency rather than expecting a batch endpoint. ### Can I limit what my agent is allowed to do with the Enrichley API? Yes. Because you run Jentic One yourself, your own rules decide which Enrichley operations the agent can reach, so you can allow only POST /validate-single-email for deliverability checks while excluding POST /profile-enrichment, or restrict it to GET /me for read-only account and quota lookups. An operation is callable only if you include it in that allowed set. Your Enrichley API key is stored once by your own instance and injected at execution time, so the agent never sees the credential directly.