Skip to content

How do you create an API key for developers?

Last reviewed 2 min read

Under For developers, tap Create access next to API keys, choose the permissions and confirm with your code. tiaki shows the secret only once. Copy it right away.

Open in the app Who can do this? Owner, Manager
On this page

With For developers, other programs can fetch your contacts from tiaki, including proof of consent. These are, for example, newsletter services like Brevo or CleverReach, your CRM, or Zapier and Make. A key can’t change posts, accounts or settings.

Step by step

  1. In the sidebar, open Workspace and then General. Choose For developers.
  2. In the API keys card, tap Create access.
  3. Enter a name, for example “Brevo”.
  4. Choose what the key may do: read contacts, read consents and, if needed, create and update contacts.
  5. Choose how long the key is valid, or that it never expires.
  6. Enter the verification code from your authenticator app and create the key.
  7. Now copy the Key ID and the Secret and enter both in your program.

Important: tiaki shows the secret only this one time. Lost it? Just create a new key and revoke the old one.

Tip: If your program asks for a “user” and Password, use the Key ID as the user and the secret as the password. If it wants a Bearer token, copy the field Bearer token (ID.secret). A guide with examples for Brevo, CleverReach, Zapier and Make is under Guide with examples.

With Log, you see every request made with a key. With Revoke, you block it right away.

Not working?

  • You don’t see a button: Only owners and managers set up keys.
  • Your program is turned away: Check whether the key is expired or revoked. If you entered an address the key should work from, leave it empty for Zapier and Make. Their addresses change.
  • There are at most 120 requests per minute for each key.
  • The area is locked: It can’t be used during the trial, and existing keys answer with a refusal. They are not deleted and work again as soon as your plan is running. Choose a plan, then you can create keys.
  • Still stuck? Ask us via Ask a question in the Help Center.

Default: A new key expires after 90 days and no permission is ticked yet. Tick only what your program really needs. You can find all keys later under Workspace › For developers.

Related articles

Still have questions about this article?

Write to us – we’ll look into it personally and reply by email.

Choose language: EN