Skip to main content
Create a client key so your frontend application can authenticate requests to Circle’s client-side SDKs, such as modular wallets or user-controlled wallets. Each client key is bound to a specific host domain, iOS bundle ID, or Android package name. For details, see Client keys.

​
Prerequisites

Before you begin ensure you have:
  • Created an API key in the Circle Console.
  • Reviewed the Keys page for background on client key usage and security best practices.

​
Steps

​
Step 1. Open the API & Client Keys page

Sign in to the Circle Console and select API & Client Keys from the left sidebar.

​
Step 2. Create a client key

Select Create a key, then choose Client Key. Enter a name for your key.

​
Step 3. Configure platform settings

Configure the settings for your target platform:
  • Web: enter your Allowed Domain (for example, your.website.com, localhost, or chrome-extension://<extension-id>).
  • iOS: enter your Bundle ID (for example, com.yourcompany.yourapp).
  • Android: enter your Package Name (for example, com.yourcompany.yourapp) and Signature (SHA256) (for example, XX:XX:…:XX where X is [0-9A-F]).
If you run your web application locally, use localhost for the Allowed Domain. For Chrome extensions, use chrome-extension://<extension-id>. You can find the extension ID on the Chrome Extensions page (chrome://extensions).If your application runs on multiple platforms, create a separate client key for each platform for enhanced security.

​
Step 4. Copy your client key

After the Console confirms that your key was created, copy it and store it securely. The client key is not displayed in the Console again after you leave the page.