/ /

Unlocking Your API Key

Learn how your Kintsugi API key unlocks on the Premium plan, what to complete first, where to find your key, and what to do if it still looks locked.
Updated 24 days ago

Your Kintsugi API key connects Kintsugi to your own systems, so you can calculate tax and work with your data programmatically. API access is part of the Premium plan, and your key unlocks automatically once your plan and setup are complete. This guide shows what you need, where to find your key, and what to do if it still looks locked.


What you need before your API key unlocks

  1. An active Premium plan. Premium is set up with our team, because it is priced around your business.

  2. A payment method on file. If our team set up Premium for you on the Free plan, you activate it by completing a short checkout.

  3. Your required Account Setup steps. This includes connecting a data source, adding your physical presence, and completing your organization details, bank details, and payment setup.

Once all three are in place, your API key unlocks on its own. There is nothing else to request.


If you are not on Premium yet

  1. Go to Configuration > Billing Details.

  2. On the Current Subscription Plan card, select Upgrade.

  3. Select Talk to Sales on the Premium card and confirm your request. Our team follows up to build a plan around your business.

What happens next depends on your current plan:

  • On the Free plan: Once your plan is set up, you receive an email titled Set up payment method to activate your premium plan. Go to Configuration > Billing Details, select Setup Payment, and complete checkout. Premium unlocks right away.

  • On the Starter plan: Our team handles the change to Premium for you.

For more detail, see How to View and Change Your Kintsugi Subscription Plan.

Want to try the API first?

You can test the API before upgrading. Create a test organization to get a test-only API key. A test organization is not connected to your real data. See Creating a Test Organization.


If you are already on Premium

  1. Select Setup Account in the left navigation and make sure every required step is complete. See Setting Up Your Kintsugi Account: A Step-by-Step Guide.

  2. Go to Configuration > API Keys to view and manage your key.

To create, rotate, or delete keys for your live organization, see How to Create and Delete API Keys.


Troubleshooting: my API key still looks locked

If something is missing, Kintsugi shows a message that tells you exactly what to finish.

What you see

What to do

Set up payment to access Premium features

Your Premium plan is ready and only needs a payment method. Select Setup Payment and complete checkout.

Complete your account setup

Go to Setup Account and finish the required steps.

Complete your organization details

Select Complete Now and fill in the missing sections.

A prompt to complete your bank details

Follow the prompt to add the bank account used to pay your sales tax.

Upgrade or Talk to Sales

Your account is not on Premium yet. See If you are not on Premium yet above.

If you have finished everything and your key is still not showing:

  1. Refresh the page, or log out and log back in.

  2. Check the Current Subscription Plan card under Configuration > Billing Details to confirm Premium is showing.

  3. Already completed checkout and still locked? Please do not pay again. Contact us through the in-app chat or at success@trykintsugi.com, and include a screenshot of what you see so we can resolve it quickly.


Need help?

We are always happy to help. Reach out through the chat in the bottom right corner of your screen.

Was this article helpful?