Homarr
Integrations

Proxy an integration API request using saved credentials

POST/api/integrations/request

REST access to integration_request, Homarr's most powerful MCP tool. Call any API endpoint on a supported saved integration using its authentication and trusted certificates. Features not implemented in Homarr can still be used through this API or MCP if the upstream API supports them. Supply exactly one selector: integrationId, integrationName or integrationKind. Requires full integration access; DELETE also requires confirmed=true after user confirmation. Paths append to the saved URL. HTTP 200 can contain upstream errors: inspect ok, status and data. Limits: 10 KiB body, 16 KiB headers, 1 MiB response, 15 seconds. See https://homarr.dev/docs/management/api#call-any-integration-api-endpoint for the full contract.

Authorization

apikey
ApiKey<token>

API key which can be obtained in the Homarr administration dashboard

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/integrations/request" \  -H "Content-Type: application/json" \  -d '{    "integrationKind": "sonarr",    "method": "GET",    "path": "/api/v3/system/status"  }'
{  "integration": {    "id": "string",    "name": "string",    "kind": "autobrr"  },  "ok": true,  "status": 0,  "statusText": "string",  "data": "string"}

Change the first day of the week

Set a user's preferred first day of the week. Users can update themselves; updating another user requires admin permission.