COKIQ public API, OpenAPI file and automation apps
Use the COKIQ REST API v1 to list sites, start scans, export consent logs, create cookie rules and subscribe to webhooks, with an OpenAPI 3 file. Ready-made apps for Zapier, Make, Pabbly, Albato, Integrately and Power Automate are being submitted.
Automation apps: Integrately is in review. Zapier, Make, Pabbly Connect, Albato, Microsoft Power Automate and KonnectzIT are coming soon. Until then use the REST API or any tool that can send a webhook or HTTP request.
Install in 4 steps
- Create a free account, open Developers > API keys (cokiq.com/developers/keys), choose the scopes you need and copy the key once.
- Test it: curl -H "Authorization: Bearer YOUR_KEY" https://cokiq.com/api/v1/me should return your workspace name.
- Call the endpoints you need (sites, scans, consent-logs, cookie-rules) or load https://cokiq.com/openapi.json into Postman, Insomnia or your own client.
- To react to events, POST to /api/v1/hooks with an https URL and an event name (consent.logged, scan.completed, site.created, banner.published).
Universal script
Works on any site that allows custom code in the head. Replace YOUR_SITE_KEY with the key from your COKIQ dashboard. Use one install path per site.
<script src="https://cokiq.com/api/s/YOUR_SITE_KEY" data-key="YOUR_SITE_KEY" async></script>
Check that it works
- GET /api/v1/me answers 200 with your key and 401 without it.
- A started scan shows up in the COKIQ dashboard and in GET /api/v1/scans.
- Webhook payloads contain a visitor_hash and never a raw IP address or user agent.
Questions
Is there a Zapier app for COKIQ?
Not yet. The app is built and being submitted. Until it is live, use a Zapier Webhooks step with the REST API.
Where is the OpenAPI file?
At https://cokiq.com/openapi.json, with the human docs at https://cokiq.com/docs/api.
Does the API return visitor personal data?
No. Responses and webhooks never include raw IP addresses, user agents or other visitor PII.