Build with Confidence

Our comprehensive API documentation is available at /developers/api-docs and includes interactive examples, request/response schemas, and code samples in multiple programming languages including JavaScript, Python, Ruby, PHP, and .NET. All Ademero APIs support OAuth 2.0 authentication as the primary method, providing secure token-based access with automatic refresh capabilities. Additionally, we offer API key authentication for server-to-server integrations and JWT-based authentication for custom single sign-on implementations.

The documentation is organized by product (Content Central, AP Central, Nucleus One) and includes both REST API endpoints and webhook event references. Each endpoint is documented with required parameters, optional fields, error codes, rate limiting information, and versioning details. We also provide Postman collections and OpenAPI specifications for automated testing and integration into your development workflow. For developers building complex integrations, our API playground offers real-time testing capabilities where you can execute API calls directly from your browser and see live responses.

Ademero provides official SDKs for JavaScript/TypeScript (Node.js and browser), Python, Ruby, and .NET (C#). Our JavaScript SDK includes full TypeScript type definitions and is available via NPM, supporting both CommonJS and ES modules for maximum compatibility. The Python SDK supports versions 3.8+ and integrates seamlessly with popular frameworks like Django and Flask. All SDKs are open-source and hosted on GitHub at github.com/ademero, where you can report issues, request features, and contribute improvements.

Each SDK abstracts the complexity of direct REST API calls, providing intuitive methods for common operations like document upload, metadata management, workflow automation, and webhook handling. They include built-in retry logic, automatic token refresh, request rate limiting, and comprehensive error handling. For languages without an official SDK, our REST APIs follow standard conventions and work with any HTTP client library. We also provide framework-specific integration guides for React, Angular, Vue.js, Laravel, Rails, and ASP.NET Core to accelerate your development process.

Ademero webhooks provide real-time HTTP callbacks whenever specific events occur in your document management workflow, eliminating the need for polling and enabling truly event-driven architectures. You can configure webhook endpoints through the developer dashboard or programmatically via the Webhook Management API. Supported events include document.created, document.updated, document.deleted, workflow.completed, approval.requested, approval.granted, approval.denied, user.invited, user.activated, and many more. Each webhook payload includes the full event context, timestamp, user information, and relevant object data in JSON format.

Webhooks are delivered with a cryptographic signature header (X-Ademero-Signature) that you should validate to ensure requests originate from Ademero and haven't been tampered with. We implement automatic retry logic with exponential backoff for failed deliveries, attempting up to 5 retries over 24 hours before marking a webhook as failed. Your endpoint should respond with a 200-299 status code within 10 seconds to acknowledge receipt. For high-volume applications, we recommend implementing a queue-based architecture where your webhook endpoint immediately accepts the payload and processes it asynchronously. Our webhook logs provide detailed delivery history, response codes, and retry attempts for troubleshooting integration issues.

Ademero implements tiered rate limiting based on your subscription plan to ensure platform stability and fair resource allocation. Standard plans allow 1,000 requests per hour per API key, Professional plans support 5,000 requests per hour, and Enterprise plans can be configured with custom limits based on your integration requirements. Rate limits are applied per endpoint category, with separate limits for read operations (GET requests), write operations (POST/PUT/PATCH), and file uploads. Every API response includes rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) that inform you of your current usage and when limits reset.

When you exceed rate limits, the API returns a 429 Too Many Requests status code with a Retry-After header indicating how long to wait before retrying. Our official SDKs automatically handle rate limiting by implementing exponential backoff and retry logic, transparently managing these scenarios for you. For applications requiring higher throughput, we recommend implementing request batching where applicable, using webhook notifications instead of polling, caching API responses when data freshness requirements allow, and considering an Enterprise plan with dedicated API capacity. You can monitor your API usage in real-time through the developer dashboard, which provides detailed analytics on request volume, error rates, and rate limit encounters.

We offer multiple support channels designed for different needs and urgency levels. Our developer community forums at /community/developers provide peer-to-peer support where experienced developers and Ademero engineers share solutions, with most questions answered within hours. For self-service support, our comprehensive knowledge base includes troubleshooting guides, integration tutorials, and best practices documentation available 24/7. GitHub Issues on our SDK repositories receive responses from our engineering team within 1-2 business days and are ideal for reporting bugs or requesting SDK features.

Direct developer support is available through our contact form at /contact?type=developer, with typical response times of 4-8 hours during business hours (9 AM - 6 PM EST, Monday-Friday). Enterprise customers receive priority support with guaranteed 2-hour response times for critical issues and access to a dedicated Slack channel with our engineering team. We also host weekly Developer Office Hours every Thursday at 2 PM EST, offering 30-minute live Q&A sessions where you can ask questions directly to our engineers, see live troubleshooting demonstrations, and get previews of upcoming API features.

Yes, every Ademero account includes access to a full-featured sandbox environment that mirrors production functionality without affecting live data or incurring usage charges. The sandbox environment is accessible at sandbox.api.ademero.com and uses separate authentication credentials (sandbox API keys) that you can generate from the developer dashboard. This allows you to safely test integrations, experiment with API calls, validate webhook implementations, and develop new features without any risk to your production environment. All API endpoints available in production are also available in the sandbox with identical behavior.

The sandbox environment includes test data generators that can create realistic documents, users, workflows, and approval chains for comprehensive integration testing. You can reset sandbox data at any time to start fresh, and there are no rate limits applied to sandbox requests, allowing unlimited testing. Webhook endpoints configured in sandbox mode receive test events that you can trigger manually to validate your integration logic. We recommend developing and testing all integrations in the sandbox environment first, then migrating to production only after thorough testing. Our deployment guides include step-by-step instructions for promoting sandbox configurations to production, including environment variable management, credential rotation, and smoke testing procedures.