{"id":"openapi-postman-import-five-minutes","slug":"import-unlocked-crm-openapi-postman","title":"Import the unLocked CRM OpenAPI Spec Into Postman in 5 Minutes","excerpt":"Hit every CRM endpoint from Postman without writing a line of code. This walkthrough covers importing the live spec, configuring auth, and saving an environment for sandbox vs. production.","content":"<p>Postman is the fastest way to explore the unLocked CRM API interactively. With OpenAPI 3.1 import, you get a fully populated collection — auth, examples, and folders — in under five minutes.</p>\n\n<h2>Step 1: Import the Spec</h2>\n<p>In Postman, click <strong>Import → Link</strong> and paste <code>https://unlockedcrm.ai/openapi.json</code>. Postman will create a collection named \"unLocked CRM\" with one folder per tag (Contacts, Pipelines, Policies, etc.).</p>\n\n<h2>Step 2: Create an Environment</h2>\n<p>Add an environment with two variables: <code>baseUrl</code> (set to the production server) and <code>apiKey</code> (your unLocked API key). Postman binds these to every request automatically.</p>\n\n<h2>Step 3: Configure Auth at the Collection Level</h2>\n<p>Open the collection settings → Authorization tab → choose <strong>API Key</strong> → key name <code>x-api-key</code>, value <code>{{apiKey}}</code>, location Header. Every endpoint inherits this — no per-request auth setup.</p>\n\n<h2>Step 4: Run the Smoke Test</h2>\n<p>Hit <code>GET /whoami</code> first to verify your key works. Then try <code>GET /contacts?limit=5</code>. If both return 200, you're wired up.</p>\n\n<h2>Step 5: Save Examples and Generate Code</h2>\n<p>Right-click any successful response → <strong>Save Example</strong> to keep it as a reference. Use the <strong>&lt;/&gt; Code</strong> sidebar to copy a curl, Node, Python, or Go snippet straight into your codebase.</p>\n\n<p>Total time: ~5 minutes. You now have a sharable, version-controlled API workspace your whole team can use.</p>","category":"Tutorials","featureLink":"/mcp-server","cluster":"mcp-api","date":"2026-11-18","lastModified":"2026-11-18","readTime":"6 min","author":"unLocked Team"}