[POST] .../v1/integration/add
Adds local integration. Use this method to register an account-local integration that calls back into infrastructure controlled by the account owner. The method creates the integration in the external REGOS integration registry, immediately connects it to the current account as a local integration, creates the access token and connected integration row and returns a standard OkResult with no payload. The request body is required; name is schema-required, webhooks are optional, endpoint is required when webhook subscriptions are provided, endpoint must be an absolute public HTTP or HTTPS URI and localhost/private/local addresses are rejected by the persistent layer. The current request user must have permission to manage local integrations and the API access tariff option must be enabled. Missing body, missing name, missing endpoint for webhook subscriptions, invalid endpoint, denied access, disabled tariff option, external registry errors, duplicated lookup results and database failures are returned as HTTP 200 ErrorResult business errors.
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| endpoint | String | Optional | Integration endpoint URL. Required when webhook subscriptions are provided. The endpoint must be an absolute non-local HTTP or HTTPS URI. |
| name | String | Required | Integration name. |
| webhooks | Array of String | Optional | Optional webhook event names subscribed by the local integration. If at least one non-empty webhook name is provided, endpoint is required. |
Request Example
{
"name": "Warehouse bridge",
"endpoint": "https://bridge.example.test/regos",
"webhooks": [
"ItemAdded",
"DocPurchasePerformed"
]
}
Response Parameters
| Name | Type | Description |
|---|---|---|
| ok | Boolean | Indicates whether the request completed successfully. |
Response Example
{
"ok": true,
"result": null
}