All guides
API keys

API keys

~3 min read

Closr API keys let outside tools send leads into your pipeline. Use one for a Zapier zap, a Make scenario, a Webflow contact form, or any custom integration that can make an HTTP request. The key is not for the Closr mobile app.

Creating a key

  1. 1Go to Settings, then Connections, then Integrations.
  2. 2Scroll to the 'API keys' section.
  3. 3Type a label (optional, max 80 characters). Examples: 'Webflow contact form', 'Zapier FB Lead Ads'.
  4. 4Click Generate.
  5. 5A banner appears with a 'COPY NOW' warning that you will not see this key again. Copy the key immediately. Closr stores only a hash and cannot show it again.

The key starts with 'closr_'. Your team can have up to 10 active keys. If you try to create an 11th, you see: 'Maximum 10 API keys per team. Revoke an unused one and try again.'

Using the key to send leads

POST to https://getclosr.app/api/leads/inbound with the header x-api-key: [your key]. Required field: firstName. Optional: lastName, email, phone, company, title, source, tags, propertyAddress, value, message. A successful call returns the new contactId and leadId, and fires your LEAD_CREATED automation.

An expandable details section in the API keys section shows a ready-to-run cURL example. Use it to test before wiring up Zapier.

Keys are team-scoped

Any teammate can create or revoke a key. Treat keys like passwords. Do not put them in a public Git repo or paste them into Slack. Anyone with the string can post leads as your team.

Revoking a key

Click the trash icon next to the key. The dialog says: 'Revoke this key? Any Zap or external tool using it will stop working.' Confirm and it is gone immediately. Any tool still using that key gets a 401 on its next call. The action is permanent.

Rotating a key

  1. 1Generate a new key with a fresh label.
  2. 2Paste the new key into the integration that was using the old one.
  3. 3Test the integration (send a test lead).
  4. 4Revoke the old key.

Related guides

  • •`web-tracker-install` for putting the page-view snippet on your site.
  • •`lead-intake` for posting form submissions and Facebook Lead Ads into your pipeline.