Connect AvePoint
AvePoint is a Microsoft 365 data protection and governance vendor. A partner manages its customers in AvePoint Elements for Partners. Backups of Microsoft 365 run in Cloud Backup for Microsoft 365,…
Written By Christopher Scaminaci
Last updated 13 days ago
AvePoint is a Microsoft 365 data protection and governance vendor. A partner manages its customers in AvePoint Elements for Partners. Backups of Microsoft 365 run in Cloud Backup for Microsoft 365, which belongs to AvePoint Online Services. StackJack connects an AI assistant to both products through AvePoint's published APIs.
Connecting AvePoint to StackJack gives your AI assistant a family of avepoint_ MCP tools. MCP (Model Context Protocol) tools are the standardized commands an AI assistant can call through StackJack.
With them, your AI can:
- See your customers - the customers under your partner, their Microsoft 365 tenants, their services and licenses, and the protected objects and users in each tenant
- Follow the work - jobs, job reports, scan profiles and their change history, audit logs, and the Cloud Backup jobs, unusual activities, backup frequency and retention policy
- Review posture - baselines and their deviation reports, risk management findings, Azure cost and security issues, and user and workspace management data
- Run a large account reseller practice - resellers, their pooled subscriptions, allocation usage history and the reseller audit trail
- Change things (on Pro plans) - onboard a customer, add a service, add tenants to modules, generate a consent link, change baselines and user attributes, accept or reject pooled subscriptions, and start a restore
How StackJack authenticates to AvePoint
AvePoint does not use a user name and password for its API. You create an app registration in each product, and StackJack signs in with it. StackJack asks AvePoint for a one-hour access token on its own, for exactly the permission the tool needs, keeps the token and renews it as long as it is in use. You never copy a token, and the AI never sees one.
The two products use two separate app registrations:
- Elements for Partners - required. It gives the customer, service, job, baseline, risk, user management, workspace management and pooled subscription tools. It uses one fixed address, so you do not enter one.
- Cloud Backup for Microsoft 365 - optional. It gives the Cloud Backup tools and two AvePoint Online Services tools. You choose the data center your tenant is in, and that choice decides the address StackJack calls.
If you do not add the Cloud Backup registration, only the Cloud Backup tools stop working. The Elements tools run as before.
Creating the Elements app registration
- Sign in to AvePoint Elements and open Settings, then API app registration. Register a new app.
- Choose the permissions you want the AI to have. Each tool needs exactly one permission, for example
elements.customers.read.allfor the customer list. A tool whose permission you did not grant fails with a message that names the permission, and no other tool is affected. - Create a client secret (it can last 1, 2 or 3 years), or upload a certificate.
- Copy the application (client) ID and, for a secret, the secret value. AvePoint shows the secret only once.
- Note the environment you signed in to: Commercial, U.S. Government, AOS2 or FedRAMP (Project Hosts).
Creating the Cloud Backup app registration (optional)
- Sign in to AvePoint Online Services and open the app registration for the modern API.
- Grant the
microsoft365backuppermissions you want, for examplemicrosoft365backup.jobInfo.read.allto read jobs andmicrosoft365backup.restore.readwrite.allto start a restore. The two AvePoint Online Services tools need their own permissions:audit.read.allfor the audit records andautodiscovery.readwrite.allfor the scan jobs. - Create a client secret or upload a certificate, and copy the application (client) ID and the secret.
- Note the data center your tenant is in and the environment.
Using a certificate instead of a secret
A certificate registration signs in without a secret. StackJack signs a short-lived proof of identity with the certificate's private key, and the private key is stored encrypted in Azure Key Vault.
StackJack takes the certificate and the private key as PEM text, with the key unencrypted. If you have a .pfx file, convert it with OpenSSL:
openssl pkcs12 -in certificate.pfx -clcerts -nokeys -out certificate.pem
openssl pkcs12 -in certificate.pfx -nocerts -nodes -out private-key.pem
Paste the contents of certificate.pem into Certificate (PEM) and the contents of private-key.pem into Private key (PEM). Use an RSA key. Keep the files private and delete them when you are done.
Connect it in StackJack
- Open Connectors, then AvePoint.
- In the Elements for Partners section, choose the Environment, enter the Application (client) ID, choose Client secret or Certificate, and enter the secret, or the certificate and the private key.
- To add Cloud Backup, fill in every field of that section: Data center, Environment, Application (client) ID and the secret or the certificate. Leave the section empty to skip it. A section that is only half filled is refused.
- Click Test connection. StackJack signs in with each registration you entered and reads one page of a list. Both steps change nothing.
Enter all the values again whenever you save the connection, including when you only rename it.
What is worth knowing before you start
The registration's permissions decide what AvePoint allows
Every call acts as the app registration, so the AI sees and changes only what the permissions you granted allow. There is no per-person attribution: every call is made as the app. When a registration lacks the permission a tool needs, the tool says which permission is missing, and the refusal does not count against the connection. Grant the permissions the AI needs and no more.
Some tools accept either of two permissions
For a few baseline tools the vendor allows either a read permission or a read-write permission. StackJack asks for the first, and if AvePoint reports that the registration lacks it, StackJack tries the other.
Paging
Elements lists page with pageIndex, which starts at 1, and pageSize, which is at most 100. Some lists use an opaque skipToken that you pass back unchanged. The Cloud Backup lists page with pageIndex, which starts at 0.
StackJack never follows a link from an answer on its own.
About thirty Elements read tools use a POST request with a JSON filter, because that is how AvePoint offers them. They are still reads.
Changing things
The tools that onboard customers, add services, add tenants to modules, generate authorization links, add, accept or reject pooled subscriptions, change a user's account or password setting, apply baselines to a tenant, or start a restore are on the Pro tier, are marked destructive and ask for approval before they run. Other changes, such as creating a baseline and user attributes, are Pro and ask for approval too. A service or a pooled subscription can cost money, and a restore overwrites or adds data, so check what a call will do before you approve it.
Links and passwords are never recorded
The storage profile list can answer storage passwords and keys. The two authorization-link tools answer with a consent URL. Whoever opens that URL can grant AvePoint access to a customer's Microsoft 365 tenant. StackJack never records those answers and never turns them into download links. Onboarding a customer sends a password, and StackJack never records that call's arguments.
What is not offered
StackJack offers the Elements for Partners v3 API, the Cloud Backup for Microsoft 365 API and two AvePoint Online Services calls (audit records and scan jobs). The older Elements address family that AvePoint has replaced is not offered, and neither are AvePoint's other products, such as EnPower, Insights, Opus or Confide.
When AvePoint refuses a call
- The app registration is refused: the application ID or the secret is wrong, the secret has expired, or the certificate does not match the registration. Create a new secret or check the certificate, then paste the values again.
- A permission is missing: the answer names it. Add it to the app registration in AvePoint and try again.
- The environment does not match: a registration made in one environment cannot sign in at another. Choose the environment where you created it.
- Not found: check the ids with
avepoint_elements_list_customers,avepoint_elements_get_m365_tenant_info,avepoint_elements_list_users,avepoint_elements_list_jobsandavepoint_m365_list_jobs. - Rate limited: AvePoint does not publish a limit. StackJack paces its calls and backs off when AvePoint asks it to slow down.
Client secrets expire. Replace the secret in StackJack before its date.
Plans and limits
Reads are available on the Free tier. The tools that change things are Pro. Business reaches the same tools as Pro and differs by monthly call quota.
See the generated AvePoint tool reference for the current inventory, plan assignment, input schemas and destructive-action labels.
AvePoint tools
avepoint_ · 78 tools · Free 49 · Pro 29
Customers
Customer tenants and apps
Services and licensing
Tenant seats and products
Jobs and scan profiles
Audit
Large account reseller
Azure cost and security
Baseline management
Risk management
User management
Workspace management
Cloud Backup for Microsoft 365
AvePoint Online Services
Was this helpful?
More in Connector guides
Connect 3CXConnect AbleSignConnect Acronis Cyber Protect CloudConnect Action1Still need help? Ask the team