Skip to main content

Add Coinbase as a social connection

Before you start

Enabling OAuth with Coinbase allows your users to sign up and sign in to your Clerk app with their Coinbase account.

Configure for your development instance

For development instances, Clerk uses preconfigured shared OAuth credentials and redirect URIs—no other configuration is needed.

  1. In the Clerk Dashboard, navigate to the SSO connections page.
  2. Select Add connection and select For all users.
  3. Select Coinbase from the provider list.

Configure for your production instance

For production instances, you must provide custom credentials.

To make the setup process easier, it's recommended to keep two browser tabs open: one for the Clerk Dashboard and one for the OAuth page in the Coinbase Developer Platform portal.

Enable Coinbase as a social connection in Clerk

  1. In the Clerk Dashboard, navigate to the SSO connections page.
  2. Select Add connection and select For all users.
  3. Select Coinbase from the provider list.
  4. Ensure that both Enable for sign-up and sign-in and Use custom credentials are toggled on.
  5. Save the Redirect URI somewhere secure. Keep this page open.

Create a Coinbase OAuth client

Important

Coinbase has temporarily disabled new OAuth client creation and limits it to approved partners. To request access, contact your Coinbase representative and request OAuth whitelisting. Existing OAuth clients continue to work. For more information, see the Coinbase OAuth2 Quickstart.

  1. Navigate to the OAuth page in the Coinbase Developer Platform portal and select Create client. This page isn't linked from the portal's navigation — use the direct link.
  2. Complete the required fields. In Redirect URIs, paste the Redirect URI you saved from the Clerk Dashboard.
  3. Select Create client. The page will refresh and you should see the Client ID and Client Secret. Save these values somewhere secure.

Set the Client ID and Client Secret in the Clerk Dashboard

  1. Navigate back to the Clerk Dashboard where the configuration page should still be open. Paste the Client ID and Client Secret values that you saved into the respective fields.
  2. Select Save.

Note

If the page is no longer open, navigate to the SSO connections page in the Clerk Dashboard. Select the connection. Under Use custom credentials, paste the values into their respective fields.

Test your connection

The simplest way to test your connection is to visit your Clerk app's Account Portal, which is available for all Clerk apps out-of-the-box.

  1. In the Clerk Dashboard, navigate to the Account Portal page.
  2. Next to Sign-in, select the button to visit the sign-in page. The URL should resemble:
    • For development - https://your-domain.accounts.dev/sign-in
    • For production - https://accounts.your-domain.com/sign-in
  3. Sign in with your connection's credentials.

Feedback

What did you think of this content?

Last updated on

GitHubEdit on GitHub