Skip to main content

Create Connection

Creates a connection. New connections start as inactive until their first successful check.
POST https://api.opsmatic.com/v1/connections
Requires an API key with connections: write.

Headers

Authorization
string
required
Bearer ops_your_api_key

Body

service_type
string
required
n8n, make or openclaw.
service_name
string
required
A friendly label for the connection.
base_url
string
Required for n8n — the instance URL.
api_key
string
Required for n8n — the n8n API key.
api_token
string
Required for make — the Make.com API token.
organization_id
string
Assign to an organization you belong to. Omit or use "personal" for a personal connection.
curl -X POST https://api.opsmatic.com/v1/connections \
  -H "Authorization: Bearer ops_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "service_type": "n8n",
    "service_name": "Production n8n",
    "base_url": "https://n8n.example.com",
    "api_key": "n8n_api_key_here"
  }'
{
  "message": "Connection created successfully",
  "connection": {
    "id": "conn_new456",
    "service_type": "n8n",
    "service_name": "Production n8n",
    "status": "inactive"
  },
  "ingest_api_key": null
}
For openclaw connections the 201 response includes a one-time ingest_api_key — save it immediately. For n8n and Make it is null.