API Reference.
Integrate Adoptiv into your stack.
Complete API documentation for integrating Adoptiv into your applications — authentication, REST, webhooks, and SDKs.
Everything you need to ship a production integration
Authentication, REST, webhooks, SDKs — plus quick-start code you can run today.
Authenticate every request with confidence
Learn how to authenticate API requests
REST endpoints for your entire workspace
Complete REST API reference
Real-time events delivered to your stack
Set up webhooks to receive real-time events
Official SDKs for faster implementation
Official SDKs for popular programming languages
Copy, paste, and run your first request
Start with cURL, JavaScript, or Python — same endpoint, same auth header.
Built for production security expectations
TLS in transit, scoped keys, and clear separation between environments.
Who builds on the API
From first script to enterprise automation — the same surface area.
Product engineers
Embed CRM data in your product, sync bi-directionally, and automate with webhooks.
Data & RevOps
Bulk operations, ETL-friendly REST patterns, and event-driven pipelines.
Support tooling
Open tickets, update records, and trigger workflows from your help desk.
Enterprise IT
Standard OAuth-style bearer keys, clear boundaries, and SDKs your team already uses.
Predictable APIs, fewer integration surprises
Auth, REST, webhooks, and SDKs documented together — so your team ships once and maintains confidently.
Bearer keys that match how you already build
- Standard Authorization header pattern.
- Rotate and scope keys from workspace settings.
REST designed for real CRUD workloads
- Entity-oriented resources and consistent JSON.
- Errors you can map to application logic.
Webhooks for automation without polling
- Event subscriptions with structured payloads.
- Built for retries and signature verification.
SDKs so you are not parsing raw HTTP only
- JavaScript, Python, PHP, and Ruby starters.
- Stay aligned with REST versioning.
Fragile integrations start with unclear docs
When authentication, REST, and webhooks are documented in fragments, every integration becomes a custom science project. Adoptiv keeps API reference, examples, and SDK paths together — so your team ships faster and maintains with confidence.
Authentication guide
Four pillars: auth, REST, webhooks, SDKs
API authentication uses API keys. Include your API key in the Authorization header. Our REST API provides programmatic access to all Adoptiv features.
REST API docsEvents and client libraries in one narrative
Webhooks allow you to receive real-time notifications about events in your account. We provide official SDKs for JavaScript, Python, PHP, and Ruby.
Webhook docsFrom API key to live webhook in three steps
The same path every senior engineer expects — credentials, first call, subscriptions.
Create and store your API key
Generate a key in workspace settings, scope it to the right environment, and never commit it to source control.
Call the REST API
Use the Quick Start examples below — then extend to contacts, deals, and custom objects as you integrate.
Subscribe to webhooks
Register endpoints, verify signatures, and process events idempotently for reliable automation.
Explore the full API surface
Authentication, REST, webhooks, and SDKs — every pillar documented in one place.
Authentication
Learn how to authenticate API requests
API authentication uses API keys. Include your API key in the Authorization header.
REST API
Complete REST API reference
Our REST API provides programmatic access to all Adoptiv features.
Webhooks
Set up webhooks to receive real-time events
Webhooks allow you to receive real-time notifications about events in your account.
SDKs
Official SDKs for popular programming languages
We provide official SDKs for JavaScript, Python, PHP, and Ruby.
curl https://api.adoptiv.com/v1/contacts \
-H "Authorization: Bearer YOUR_API_KEY"Everything you need to know about Adoptiv
Quick answers to what sales teams ask most before getting started with Adoptiv.
Include your API key in the Authorization header as a Bearer token: Authorization: Bearer YOUR_API_KEY. Full authentication topics live under /docs/api/authentication.
Examples in this documentation use https://api.adoptiv.com/v1/ — align your client with the versioned path shown in the REST reference.
You register HTTPS endpoints in your workspace. Adoptiv delivers JSON payloads for subscribed events. Verify signatures and handle retries idempotently — see /docs/api/webhooks.
We document official SDKs for JavaScript, Python, PHP, and Ruby. See /docs/api/sdks for installation and usage aligned with our REST API.
Yes. Use a sandbox or staging workspace key where available, and start with the Quick Start tabbed examples (cURL, JavaScript, Python) on this page.
Contact Support from your workspace or via /contact. Link engineers to request IDs, endpoint paths, and webhook delivery logs for faster resolution.
Need Help?
Our developer support team is here to help you integrate Adoptiv
