Approval process
When your integration is ready, you’ll need to submit it for verification before it can go live. As explained in How it works, this is the final step to switch your app from Inactive (development mode) to Active (production).
To start the process, contact [email protected] or the sales manager you’ve been in touch with to address the following:
- Enterprise subscription
- If this is a new product (not part of our legacy Integrations program), you’ll need an Ahrefs Enterprise subscription before activation.
- If you are a legacy app owner, no Enterprise subscription is required.
- User connection flow
- A detailed description and screenshots showing:
- How Ahrefs users connect their account to your app (all possible steps)
- How a user profile looks before and after connecting an Ahrefs account
- How Ahrefs data is displayed inside your app
- How users can revoke access to their Ahrefs account
- A detailed description and screenshots showing:
- Authorization process video
- A full, unedited recording of the OAuth flow, from starting the connection to showing a user profile with a connected Ahrefs account in your app.
- Voiceover is encouraged to explain each step.
- Important: Access tokens must never be exposed to users, either during authorization or afterward. This will be verified during the approval stage (see OAuth guide).
- API usage details
- Which endpoints you use and what data you pull from them
- How your integration works with this data
- What measures you take to save users’ API units (see recommendations)
Once your app passes verification, we’ll switch it to Active status. At that point:
- Users will be able to connect their Ahrefs account via your production OAuth credentials
- Our sales team will notify you and offer to list your app in the Apps Gallery