Skip to content

Create and revoke API keys

An API key lets another system read your data without a person signing in. In LintelCRM today, a key gives read-only access to your property listings feed and nothing else. You give the key to your website developer. You can see every key, when it was last used, and switch one off at any time.

You need the permission to manage API keys. Owners and admins have it. Other roles can be given it. The API Keys tab appears in Settings for anyone with any API key permission, but listing, creating and revoking keys needs the manager level.

  1. Open Settings and choose API Keys.
  2. Select Generate New Key.
  3. Enter a Key name so you can recognise it later, for example “Agency website”. The name is required: “Give the key a name.” It can be up to 120 characters.
  4. Optionally set an Expiry (optional) date. It must be in the future and within 10 years. Leave it empty for a key that never expires.
  5. Check that Access reads Property feed · read-only and select Generate key.
  6. The window API key created shows the key once. Select Copy key and give it to your developer in a safe way, not in an open email or chat.

The warning in the window is exact: “Copy this key now. For your security we store it hashed and cannot show it again.” Give each website or developer their own key, so you can revoke one without affecting the others.

Under API keys the table lists each key with Name, Key, Access, Last used, Created and Status. The heading counts “active” and “total” keys.

  • Key shows only the start of the key, so you can tell keys apart. The full key is never shown again.
  • Access reads Feed · read-only.
  • Last used shows the date the key last fetched your feed, or Never. Use it to find keys that are no longer needed.
  • Status is Active, Revoked or Expired.

Above the table, Your property feed shows the feed address, a Copy button, a sample request and a link to the listing.v1 schema. See Website listing feed for what the feed contains.

Revoke a key when a developer leaves, the key was shared by mistake, or you no longer use it.

  1. Open Settings, then API Keys.
  2. Find the key and select Revoke at the end of its row. Only Active keys have this button.
  3. Read the prompt “Revoke API key?”. It says the key “will stop working immediately” and “This cannot be undone.”
  4. Select Revoke. The status changes to Revoked.

To replace a key, generate a new one first, give it to your developer, then revoke the old one. A revoked key cannot be switched back on, so generate a new key instead.

  • A key is revoked. The next request that uses it is refused with “Invalid, revoked or expired integration token.” and a 401 error. Any website using it loses access to your feed straight away, and the listings on that website stop updating. The row stays in the table as Revoked for your records.
  • A key expires. It stops working at the expiry date, with the same 401 message, and shows Expired. Generate a new key and give it to your developer before the date.
  • You lose the key. It cannot be shown again. Revoke it and generate a new one.
  • A request has no key. It is refused with “Missing integration token.” and a 401 error.
  • A key is used too often. After 60 requests in a minute (the default limit) the feed answers 429 “Too many requests” and a Retry-After time. The developer should slow down and fetch only what changed.
  • The agency account is inactive or not in good standing. Keys stop working until the account is back in good standing, but they are not revoked. See Billing and your plan.
  • You do not see the API Keys tab. Your role has no API key permission. Ask an owner or admin. See Roles and permissions.