Home Services Process Contact

API Reference

Complete documentation for the AI Conexus REST API. Build powerful automations and integrations.

Authentication

All API requests require authentication using your API key in the header.

Header
Authorization: Bearer YOUR_API_KEY

Automations

GET /v1/automations List all automations

Parameters

ParameterTypeDescription
limitintegerMaximum number of results (default: 20, max: 100)
offsetintegerNumber of results to skip
statusstringFilter by status: active, paused, draft

Response

JSON
{ "data": [ { "id": "auto_abc123", "name": "Customer Support Bot", "status": "active", "trigger": "webhook", "created_at": "2026-01-15T10:30:00Z" } ], "has_more": true }
POST /v1/automations Create an automation

Request Body

ParameterTypeDescription
namerequiredstringName of the automation
triggerrequiredstringTrigger type: webhook, schedule, event
actionsarrayList of action configurations
configobjectAdditional configuration options

Example Request

JSON
{ "name": "Lead Scoring Bot", "trigger": "webhook", "actions": ["classify", "score", "notify"], "config": { "model": "gpt-4", "threshold": 0.8 } }
GET /v1/automations/:id Retrieve an automation

Retrieves the details of an existing automation.

PUT /v1/automations/:id Update an automation

Updates the specified automation with the provided parameters.

DELETE /v1/automations/:id Delete an automation

Permanently deletes an automation. This action cannot be undone.

Executions

GET /v1/executions List execution history

Returns a list of all automation executions with status and results.

POST /v1/executions/:id/retry Retry a failed execution

Retries a failed execution with the original parameters.

Integrations

GET /v1/integrations List connected integrations

Returns all connected third-party integrations for your account.

POST /v1/integrations/connect Connect a new integration

Initiates the OAuth flow for connecting a new integration.