Platforms

Private preview Working end to end for the accounts that use it; details can still change. Tell us at contact@agentaos.ai before you rely on it, and we support you directly. See Product release phases.

A platform is an AgentaOS account that manages other businesses. You build software for other people: an agency that launches products for clients, a site builder, a marketplace of apps. Each of your clients gets its own business on AgentaOS. It sells under its own name, gets its own invoices and payouts, and you run it with your own API key. AgentaOS stays the merchant of record for every sale, yours and your clients’.

Two kinds of business

A client's business

Someone else’s company. It is verified on its own, including an identity check that only the client can complete. You can take a share of each of its sales.

Another app of your own company

A second product you own (“same company”). It is verified and priced with you. It carries no share and no identity check of its own.

You choose when you create the business: sameLegalEntity: true in the SDK, --same-company in the CLI.

Who does what

Step	Who does it
Create the business	You
Invite the client to log in (optional)	You. We email the invitation, or you send the link yourself.
File the business details, product and declarations	You or the client. If you file it, the review records that the platform filed it, and our reviewers see that.
Identity check	Only the client. You can generate the link and send it; you cannot complete it for them.
Create products, checkouts and payment links	You, acting as the business, or the client
Set your share of its sales	You, in the dashboard only
Receive its webhook events	Your own webhook endpoint, automatically

Most clients never log in. You can run everything for them and only send them the identity check link. Removing a business you manage, or transferring it to another platform, is not in the dashboard today. Contact us at contact@agentaos.ai.

White-label: create the business with sendInvitationEmail: false and we send no email. You get inviteUrl back and send it to your client yourself, under your own brand.

Acting as a business

Every API call can run as a business you manage. Send its id in the AgentaOS-Account header, or pass { business } in the SDK, or --business <id> in the CLI. Without it, the call acts on your own account.

const agentaos = new AgentaOS(process.env.AGENTAOS_API_KEY!);

// One call only
await agentaos.checkouts.create({ amount: 49, currency: 'EUR' }, { business: biz.id });

// Or a client on which every call runs as the business
const client = new AgentaOS(process.env.AGENTAOS_API_KEY!, { business: biz.id });

Only your own key or session may act for a business you manage. Any other id returns 403 You cannot act as this business. See Acting for a business.

Next steps

Build a platform

The five steps, in the SDK and the CLI.

Platform fees

Your share of each client sale, and when it is paid.

Platform webhooks

One endpoint for all your clients’ events.

Businesses (SDK)

Every method, parameter and field.

Getting started

Build with AI agents

Sell

Merchant of Record

Payouts

Webhooks

For customers

Platforms

Two kinds of business

A client's business

Another app of your own company

Who does what

Acting as a business

Next steps

Build a platform

Platform fees

Platform webhooks

Businesses (SDK)

​Two kinds of business

A client's business

Another app of your own company

​Who does what

​Acting as a business

​Next steps

Build a platform

Platform fees

Platform webhooks

Businesses (SDK)

Two kinds of business

Who does what

Acting as a business

Next steps