en
Getting startedSign in and create an API key

Sign in and create an API key

Sign in to your dashboard, then mint the API key your integration will authenticate with.

Sign in

1
Open the dashboard

Go to crisphive.com/login and enter the phone number or email you registered with — sign-in is passwordless.

2
Verify

Email gets a magic link (with a one-time code fallback); phone gets an OTP code. Verifying signs you in and drops you on the dashboard.

Create an API key

Keys are created in the Crisphive portal as described below. Once you have one, paste it on the docs home page to power the try-it console throughout these docs.

1
Open Settings → Developers

In the dashboard, head to Settings → Developers → API Keys. Use the Live/Sandbox switch to pick the environment the key belongs to.

2
Create the key

Click create, give the key a name, and choose full access or specific permission scopes. Pick the key’s lifetime here too — 30 days by default, from 1 up to 365. It is fixed for the life of the key and cannot be extended later; to renew, you’ll create a replacement key.

3
Copy the secret once

The plaintext secret is shown a single time at creation — chsk_live_… for live, chsk_test_… for sandbox. Store it in your secret manager; afterwards only a masked form like chsk_live_••••3f9a is visible, and you can revoke the key any time.

API keys are server-side secrets. Never embed them in a browser, mobile app, or public repository — use the sandbox key while developing and swap to live for production.

Make your first request

Verify the key works with a single call — list your customers and meet the response envelope:

curl "https://api.crisphive.com/v1/customers" \
  -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT"