Add Bearer Authentication for Cryvis in Make.com
Set Authorization Bearer headers for Cryvis in Make.com HTTP modules, reuse connections, and rotate API keys without rewriting scenarios.
Cryvis authenticates every extraction request with a Bearer API key:
Authorization: Bearer sk_live_...In Make, that header lives on HTTP — Make a Request (or an HTTP connection template). Missing or wrong keys return 401 with AUTHENTICATION_ERROR.
Hub: Make.com + Cryvis. Keys: Console → API keys. Docs overview: Documentation.
Create a key
- Sign in to Cryvis and open API keys in Console.
- Create a key; copy it immediately (shown once).
- Store it in a password manager—not in a public scenario blueprint share.
Prefer separate keys for staging vs production Make organizations when you can.
Header on HTTP — Make a Request
| Setting | Value |
|---|---|
| Request headers → Name | Authorization |
| Request headers → Value | Bearer sk_live_YOUR_KEY |
Include the word Bearer and a single space. Do not wrap the key in quotes.
HTTP module
Headers:
Authorization: Bearer sk_live_...
Body: multipart ...Reuse without pasting the key twelve times
Options that scale:
- Make data store / variable — store
CRYVIS_API_KEY; mapBearer {{key}}in each HTTP module. - HTTP “Make an API Key Auth connection” (or custom auth connection) — if your Make plan/UI supports API key connections for HTTP, put the key there once and select the connection on each module.
- Scenario input / team variable — for promotion across environments.
Avoid committing blueprints that embed live keys to git or public Make template galleries.
Rotation procedure
1. Create new key in Console
2. Update Make variable / connection with new key
3. Run one test extraction (invoice or custom)
4. Revoke old key in Console
5. Confirm scheduled scenarios still greenIf you revoke first, every incomplete execution fails with 401 until Make is updated—prefer create → update → revoke.
Errors that look like auth but aren’t
| Status | Code | Meaning |
|---|---|---|
| 401 | AUTHENTICATION_ERROR | Missing/invalid key |
| 403 | AUTHORIZATION_ERROR | Key valid but not permitted |
| 402 | CREDIT_ERROR | Auth OK; no credits |
Handle 402 separately from 401 in Slack alerts so finance tops up credits instead of rotating keys. Handle API errors.
Security notes
- Restrict Make organization access; HTTP modules expose headers to editors.
- Use Error Handler screenshots carefully—they can include Authorization values in logs.
- Do not put the key in the URL query string; Cryvis expects the header only.
Smoke test
curl -s https://api.cryvis.com/v1/custom-extractors \
-H "Authorization: Bearer sk_live_..."Or POST a tiny invoice image to /v1/documents/invoice. Same header Make will send. Full connection pattern: Connect REST API. Multipart after auth works: Send multipart form data.
Checklist
-
Authorizationheader present - Value starts with
Bearer - Key stored in one rotatable place
- 401 vs 402 alerts distinguished
- Old keys revoked after rotation
With auth centralized, cloning scenarios for Invoice, Receipt, or Custom is mostly URL and field-name changes.