Check and change your Paddle account settings from your AI agent or the API

What's new?

You can now set up and check your Paddle account using the Paddle API, without logging in to the Paddle dashboard.

Get and update account settings like your default payment link, checkout payment methods, tax settings, and balance currency. Check your verification status, create client-side tokens, check that your checkout domains are approved, and look up the countries and currencies that Paddle supports.

AI agents connected to the Paddle MCP server can do all of this too, so you can ask an agent to set up checkout, check your account configuration, or tell you whether your account is ready to go live.

How it works

API root

The API root returns details about the credentials that you're using, including which account you're authenticated against, whether you're working in sandbox or live, and the permissions that you have. Use it to check an API key or an MCP connection before you make other requests.

It doesn't require any permissions. A request with a key that isn't valid fails with a 403 error, and a request with no API key succeeds but doesn't include an account.

Account

Account operations return the business identity of the account that you're authenticated as, including its Paddle ID, legal name, display name, website, and contact email. Use them to check the business details that appear on invoices and other documents, or to update your contact email.

Getting your account requires the account.read permission, and updating it requires account.write. You can only update the contact email. To change anything else, contact Paddle support.

Settings

Settings operations let you get and update account-level settings for checkout, tax, and currencies. Use them to set up checkout and tax without the dashboard, or to check your configuration before you go live.

Each setting has its own read and write permissions, except checkout settings, which share checkout_settings.read and checkout_settings.write.

In live accounts, your default payment link must be on an approved domain. Submit domains for approval in the Paddle dashboard, then use checkout domains to check that a domain is approved before you set it. In sandbox, the domain doesn't need to be approved.

Verifications

Verifications show whether an account is ready for live payments, and which steps still need to be completed. Use them to check whether you can go live: list verifications with verification_type=onboarding, then check the status:

• completed means the account is ready.
• action_required means there's something to complete in the Paddle dashboard.

Verifications are read-only, only apply to live accounts, and require the verification.read permission.

Countries and currencies

Countries and currencies return reference data about the countries that Paddle knows about and the currencies that Paddle supports. Use them to populate country and currency pickers, validate addresses, and check the minimum charge before you create a price.

They describe what Paddle supports, not what's turned on for your account, so they don't require any permissions.

Configure your account from your AI tools

The Paddle MCP server and Paddle agent skills pick up the new operations, so you can ask an agent to check and configure your account without leaving your editor. For example:

• "Is my Paddle account ready to accept live payments, and what's outstanding?"
• "Set my default payment link to my checkout page."
• "Which payment methods are turned on for checkout, and what's my default tax mode?"

Updating settings requires write permissions, like checkout_settings.write. A live MCP server connected with OAuth starts with read access, so grant write access before you ask an agent to change settings.

If a request returns a forbidden error, your agent can get the API root to see which permissions it has, then tell you which one to add to your API key or MCP connection. You can also make the change in the Paddle dashboard.

Next steps

This change is available in version 1 of the Paddle API.

These are new operations, so it's a non-breaking change, meaning it doesn't impact existing integrations.

Existing API keys don't inherit the new permissions. To use the account, settings, and verification operations, add the permissions that you need to your API key. The API root, countries, and currencies operations don't need any permissions.

To get started, work through the go-live checklist. It shows how to complete each step in the Paddle dashboard or using the API. For the full reference, see the API root, account, settings, verifications, countries, and currencies overviews.