{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-agen-for-work/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["Notification","LightboxImage"]},"type":"markdown"},"seo":{"title":"Ahrefs integration","siteUrl":"https://developers.frontegg.com/","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ahrefs-integration","__idx":0},"children":["Ahrefs integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Integrating Ahrefs with Frontegg lets your application read backlink, keyword, rank-tracking, site-audit, and brand-radar data on behalf of a connected Ahrefs user through the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.ahrefs.com/api"},"children":["Ahrefs API v3"]},". Authentication is OAuth 2.0 Authorization Code with PKCE against the Ahrefs Connect program, with credentials issued by Ahrefs after your integration application is approved."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Prerequisites","type":"attention"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://ahrefs.com/"},"children":["Ahrefs"]}," account that will own the integration."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An approved ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.ahrefs.com/docs/ahrefs-connect/introduction"},"children":["Ahrefs Connect"]}," application. Production access requires an Ahrefs Enterprise plan; development and testing are free."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A publicly available product with an existing user base. Ahrefs does not approve integrations that directly compete with or replicate Ahrefs functionality."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"apply-to-ahrefs-connect","__idx":1},"children":["Apply to Ahrefs Connect"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-1-review-the-ahrefs-connect-program","__idx":2},"children":["Step 1: Review the Ahrefs Connect program"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.ahrefs.com/docs/ahrefs-connect/introduction"},"children":["Ahrefs Connect introduction"]}," and read the program overview. Ahrefs Connect is the only supported integration path for the Ahrefs API v3 — the legacy API v2 program was retired on November 1, 2025. From the introduction page, follow the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to apply"]}," link."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/ahrefs-1.42f7dc1cf991c7d8c1c3e738ba86f55a35121d75f64151b1ad404ced764bf7f6.1ce25488.png","alt":"Ahrefs Connect introduction page"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-2-open-the-application-form","__idx":3},"children":["Step 2: Open the application form"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to apply"]}," page, click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["application form"]}," link. Ahrefs hosts the submission form on HubSpot Forms and uses it to qualify integration partners before issuing developer credentials."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/ahrefs-2.910aba85ad9b16398ec6bc47bba9e1865b4c80b0cbc8347c0b636dc5a2bfa685.1ce25488.png","alt":"Ahrefs Connect How to apply page with the application form link highlighted"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-3-submit-the-application","__idx":4},"children":["Step 3: Submit the application"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Complete every required field on the form: First name, Last name, Email, Country, Company name, Industry, Website URL, a short description of your product, and how you plan to use Ahrefs data. Ahrefs replies within two business days with next steps. Approval grants access to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ahrefs Connect"]}," developer section in your Ahrefs account."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/ahrefs-3.6c5bad746068fcf75716935ba7aa6c572830c9153cf9b1e20448741d1441e14d.1ce25488.png","alt":"Ahrefs Connect application form"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Development is free, production requires Enterprise","type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once your application is approved, you can build and test the integration in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Inactive"]}," status against your account at no cost — test OAuth flows and free API requests do not consume units. Switching the app to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Active"]}," for production traffic requires an Ahrefs Enterprise subscription."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-the-oauth-application","__idx":5},"children":["Create the OAuth application"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-4-open-the-applications-page","__idx":6},"children":["Step 4: Open the Applications page"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once Ahrefs has approved your application and enabled the Ahrefs Connect developer section on your account, sign in at ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://app.ahrefs.com/"},"children":["app.ahrefs.com"]}," and open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Account settings → Applications"]},". Approved developer accounts see a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["create your own"]}," action that opens the OAuth app management screen. On a non-approved account, the same page only lists third-party apps the user has authorized."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/ahrefs-4.b8cefb90e2303b3a5c31037d934b73bdb172843c0e268b73f3e6b74c877c0d91.1ce25488.png","alt":"Ahrefs Account settings Applications page"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-5-register-a-new-app","__idx":7},"children":["Step 5: Register a new app"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the Ahrefs Connect app creation screen, enter an ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App name"]}," (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Frontegg Integration"]},"), a short description, and your product website. Ahrefs creates the app in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Inactive"]}," status — this is the state you use throughout development to test the OAuth flow and make free API requests."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-6-configure-the-redirect-url","__idx":8},"children":["Step 6: Configure the redirect URL"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the app settings, locate the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redirect URIs"]}," field and enter your Frontegg redirect URL:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://YOUR_MCP_GATEWAY_URL/integration-callback"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YOUR_MCP_GATEWAY_URL"]}," with the MCP Gateway URL from the Frontegg portal ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Basic configuration"]}," page. Ahrefs supports separate staging and production redirect URIs — register the same Frontegg callback in both fields, or only the staging field while your app is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Inactive"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-7-copy-the-client-id-and-client-secret","__idx":9},"children":["Step 7: Copy the Client ID and Client Secret"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The app overview shows the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}," Ahrefs has issued for your integration. Keep both values handy — you will paste them into the Frontegg portal in the next section. The Client Secret is shown only on this screen, so store it somewhere safe before leaving the page."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authorized-scope","__idx":10},"children":["Authorized scope"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ahrefs Connect issues a single OAuth scope that grants access to every Ahrefs API v3 endpoint your subscription tier supports:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Scope"},"children":["Scope"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apiv3-integration-apps"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Access to all Ahrefs API v3 endpoints — Site Explorer, Keywords Explorer, Site Audit, Rank Tracker, Brand Radar, Social Media, batch analysis, subscription info, and management endpoints."]}]}]}]}]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Single scope, no refresh token","type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ahrefs Connect uses one scope (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apiv3-integration-apps"]},") and does not issue refresh tokens. Access tokens are valid for one year — after that, the user must re-authorize the integration."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configure-the-frontegg-portal","__idx":11},"children":["Configure the Frontegg portal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you have your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}," from Ahrefs, enter them in the Frontegg portal:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Frontegg portal"]}," and navigate to [ENVIRONMENT] → Integrations → Ahrefs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}," in the corresponding fields."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apiv3-integration-apps"]}," scope."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a user authorizes the integration, Ahrefs prompts them to sign in and grant your app access to their Ahrefs data."]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Keep your credentials secure","type":"attention"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Never share or commit your Client Secret to version control."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additional-resources","__idx":12},"children":["Additional resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.ahrefs.com/docs/ahrefs-connect/introduction"},"children":["Ahrefs Connect introduction"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.ahrefs.com/docs/ahrefs-connect/developers/oauth-guide"},"children":["Ahrefs Connect OAuth guide"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.ahrefs.com/api"},"children":["Ahrefs API v3 reference"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.ahrefs.com/en/ahrefs-connect/docs/how-to-apply"},"children":["How to apply for Ahrefs Connect"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/agen-for-work/connectors/redirect-url"},"children":["How to get your Redirect URL"]}]}]}]},"headings":[{"value":"Ahrefs integration","id":"ahrefs-integration","depth":2},{"value":"Apply to Ahrefs Connect","id":"apply-to-ahrefs-connect","depth":3},{"value":"Step 1: Review the Ahrefs Connect program","id":"step-1-review-the-ahrefs-connect-program","depth":4},{"value":"Step 2: Open the application form","id":"step-2-open-the-application-form","depth":4},{"value":"Step 3: Submit the application","id":"step-3-submit-the-application","depth":4},{"value":"Create the OAuth application","id":"create-the-oauth-application","depth":3},{"value":"Step 4: Open the Applications page","id":"step-4-open-the-applications-page","depth":4},{"value":"Step 5: Register a new app","id":"step-5-register-a-new-app","depth":4},{"value":"Step 6: Configure the redirect URL","id":"step-6-configure-the-redirect-url","depth":4},{"value":"Step 7: Copy the Client ID and Client Secret","id":"step-7-copy-the-client-id-and-client-secret","depth":4},{"value":"Authorized scope","id":"authorized-scope","depth":3},{"value":"Configure the Frontegg portal","id":"configure-the-frontegg-portal","depth":3},{"value":"Additional resources","id":"additional-resources","depth":3}],"frontmatter":{"category":"Marketing","seo":{"title":"Ahrefs integration"}},"lastModified":"2026-05-29T13:43:28.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/agen-for-work/connectors/marketplace/ahrefs","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}