Certify your app or agent

Before your integration can be published on the Apaleo Store, it must go through our certification process. To get started, thoroughly test your integration for any bugs or errors, then submit a certification request. After submitting, you’ll be prompted to book a pre-certification call with our Tech Partnerships team to review your integration and align on the certification process.

Pre-certification call

During the pre-certification call, we will review your form submission and validate your authentication setup, including confirming that your integration uses the OAuth grant flow. We will also review the scopes your app or agent requests to ensure they align with your stated use case and follow the principle of least privilege — meaning they should not be broader than necessary for your integration’s functionality.

Exceptions may apply to agents and agentic workflows due to the nature of the integration.

In addition, we will walk through the certification process, highlight any technical prerequisites, and answer any questions you may have. The goal of the call is to assess whether your integration is technically ready to enter certification and to clarify the certification flow and next steps.

After a successful pre-certification call, we will schedule the certification call.

Prerequisites

Make sure you’ve completed the following before the certification call:

  • Submitted the certification request form
  • Prepared an onboarding guide for your product (the Simon & Josef guide is a good reference)
  • Authentication uses OAuth 2.0 Authorization Code Grant Flow
  • Your app or agent only requests the scopes it genuinely needs — no unnecessary permissions
  • Your app or agent handles errors gracefully, including 404s
  • Your app or agent continues to work after the access token expires (3600 seconds) — i.e. token refresh is implemented correctly
  • Your integration uses webhooks instead of polling to avoid hitting rate limits
  • Your integration uses pageSize=200
  • You’ve thoroughly tested your integration end-to-end

Certification call

During the certification call, you’ll share your screen and walk us through three flows:

1. Onboarding

Show how a new account connects and sets up your app or agent from scratch. This includes the full OAuth connection, initial data retrieval, webhook setup, and any other steps required to make the integration operational. If your integration is already connected to your Apaleo account, we’ll ask you to disconnect it and complete setup again so we can review the onboarding process from start to finish.

2. Day-to-day operations

Walk us through your core workflows, key user actions, and how the integration behaves in regular use.

3. Offboarding

Show how your app or agent disconnects from an account: unsubscribing from webhooks or other active subscriptions, and cleanly closing its operation with the customer.

We’ll monitor your API usage throughout to verify correct business logic, absence of unnecessary errors, and use of webhooks instead of polling.

What happens next?

  • We’ll send you a detailed follow-up email with the outcome of the certification process.
  • If your integration passes — it will be ready to be published and listed on the Apaleo Store and Agent Hub. 🎉
  • If your integration does not pass — we’ll share detailed feedback outlining what needs to be fixed. Once the required changes have been implemented, we can schedule a short follow-up certification call to review the updates. If everything is satisfactory, your app or agent will be ready to be published and listed on the Apaleo Store and Agent Hub.
  • After certification, any significant changes to your integration’s use case or requested scopes must be communicated to Apaleo so we can support you with recertification if needed. Please submit the recertification form if you have changed or updated your integration.

FAQ

Does certification and store listing cost anything? No. There are no additional costs for certification or store listing.

Do I need to have a pilot customer? Recommended but not required. If needed, we can rely on your test account during the certification process.

Can my app or agent be listed on the store first and certified later? No. Certification is a quality requirement for store publication, and only certified integrations can be listed on the store.

My product has an open API. Can Apaleo build the integration? No. Apaleo provides an open, agent-ready API platform and welcomes integration partners to build integrations with us. We are also happy to support you with your integration-related questions.

I’ve made changes to my integration after certification. What should I do? If you’ve made significant changes to your integration’s use cases or requested scopes, you must let us know. Please submit the recertification form and we’ll support you through an update review.

Still have questions? Reach out at api@apaleo.com or book a call with our team.