Core API
RESTful API Fundamentals and Authorization
V3.0 Stable • Updated Nov 12, 2025
The AIVRA REST API allows you to programmatically trigger workflows, fetch analytics, and manage resources. All requests are made to the base URL: https://api.aivra.in/v3.
Authorization Protocol:
AIVRA uses Bearer Token authentication. Include your API key in the Authorization header of every request.
GET /v3/workflows HTTP/1.1
Host: api.aivra.in
Authorization: Bearer YOUR_API_KEY
Accept: application/json
Error Handling:
Standard HTTP status codes are returned to indicate success or failure. 401 indicates invalid keys, while 429 indicates rate limit thresholds have been reached.
Real-Time Events
Configuring Webhooks for Event-Driven Workflows
Updated Oct 28, 2025
Webhooks allow AIVRA to push real-time notifications to your server when specific events occur within your workspace.
Common Triggers:
workflow.completed: Triggered when an automation cycle finishes successfully.
billing.limit_reached: Alerted when you approach 90% of your tier capacity.
security.login_alert: Security notification for new device access.
Verification:
Each payload includes an X-Aivra-Signature header. Use your unique webhook secret to verify that the request originated from our secure infrastructure.
Ecosystem
Connecting with Salesforce and Microsoft Dynamics
Cloud Connectors
Our native CRM connectors enable two-way data synchronization between your customer records and AIVRA's predictive models.
Setup Process:
- Navigate to the 'Integrations' tab in the AIVRA Admin Console.
- Select your provider (Salesforce/Dynamics 365) and authorize via OAuth 2.0.
- Map your custom fields using our visual data-mapping interface.
- Set your synchronization frequency (Real-time or Batch).
Enterprise
ERP Data Extraction and Reporting (SAP/Oracle)
Secure Tunneling
For organizations requiring deep integration with on-premise ERP systems, AIVRA provides a secure SSH-tunneling agent to bridge the gap.
Capabilities:
- Automated Invoicing: Pull raw transaction data directly from SAP for AI-assisted reconciliation.
- Inventory Prediction: Sync historical stock levels with our forecasting engine.
- Encrypted Transport: All data is AES-256 encrypted during transit through our private gateways.