1. Create a key
In the console, open Settings › API (app.trytikt.com), then Create key.- Name — say what the key is for, for example
Make · CRM sync. One key per tool: you can then revoke one without breaking the others. - Access — Read only to read leads, lists, posts, tracked profiles and events; Read and write to also act on them (add leads to lists, discard leads, exclude companies…). See Authentication.
- Create key, then Copy. The key is shown once: paste it into your tool’s secret store now. If you lose it, revoke it and create another one.
tikt_live_EXAMPLE…: tikt_live_ followed by 32 letters and digits. Below, it is in the TIKT_API_KEY environment variable.
2. Check the key
401 means the key is missing, mistyped or revoked — see Errors.
3. Read your leads
The leads whose job role matches your ICP and who meet at least 4 of its 5 criteria:GET /v1/leads returns what the Leads page shows: the leads at your workspace’s threshold, without the ones you discarded, newest first. has_more says another page follows: Pagination shows how to read it.
4. The same call in n8n
- Add an HTTP Request node.
- Method:
GET. URL:https://api.trytikt.com/v1/leads. - Authentication: a generic Header Auth credential, with Name
Authorizationand ValueBearerfollowed by your key. - Turn on Send Query Parameters and add
criteria_met=job_roleandmin_score=4. - Run the node: the leads are in
data. Add a Split Out node ondatato get one item per lead.
Next
- Respond to TIKT from a scenario: file a lead in a list when your CRM marks it as contacted.
- Rate limits: 120 reads per minute per workspace, and how to stay well under them.
- The API reference, in the menu: every operation, with a playground where you paste your key.
