Overview
Integrate Octanist directly into your application or backend using our REST API. Create leads, link server-side form submissions to pixel sessions, update statuses, attach revenue values, retrieve conversion data, and build custom workflows around the full lead lifecycle.
What you can do with the API
The Octanist API supports the full lead lifecycle. You can create leads from your backend, send the pixel session ID with server-side form fields, update leads as they progress through your pipeline, and query your data for reporting. When a lead includes the session ID, Octanist links it to the original page views, click IDs, UTMs, and consent state captured by the pixel.
Server-side form capture
Use the API when browser-side form capture is not reliable enough or when your form already submits to your backend. Keep the Octanist pixel installed on the page, include the hidden session ID field with the form submission, then send that value with the lead creation request. This keeps the backend-created lead connected to the visitor session.
Authentication and security
Authenticate with API keys scoped to your organization. Each key can be restricted to specific operations and rotated independently. All API traffic is encrypted over HTTPS, and rate limiting protects your account from accidental overuse.
Use cases
Custom integrations
Connect Octanist to any system in your stack, including CRMs, ERPs, custom apps, or internal tools, using standard REST calls.
Session-linked lead capture
Send leads from backend forms and include the pixel session ID so Octanist can attach the original attribution context.
Data export
Pull lead and conversion data from Octanist into your own data warehouse, BI tools, or custom dashboards.
Workflow automation
Build automated pipelines that create leads, update statuses, and trigger actions based on events in your systems.
Conclusion
The Octanist API gives you the building blocks to create exactly the integration you need. Whether you're connecting a custom app, building automated workflows, or syncing data with your existing stack the API makes it possible.
