---
title: "Create a new installation."
method: POST
path: "/v3/installations/{logId}"
tags: ["Installations"]
---

# Create a new installation.

`POST /v3/installations/{logId}`

Required permission: `messages_write`

## Path parameters

- `logId` string, required

## Request body

- CreateInstallation
  - `name` string — The name of the installation. This will typically be the application name. If creating multiple installations on the same name, they will show up as one application in the UI.
  - `type` string — The type of installation. The following values will be recognized within the elmah.io but you can provide a custom type if preferred: aspnet, aspnetcore, console, azurefunction, service, windowsapp.
  - `loggers` LoggerInfo[] — A list of loggers in this installation. When calling this from a web or logging framework integration, the list will often contain just a single item which is the integration itself. If the installation is created manually, please provide all of the installed loggers in this list. Example: Elmah.Io.AspNetCore, Elmah.Io.Extensions.Logging.
    - `type` string — The type of logger. This is typically set by the logging/web framework integration.
    - `assemblies` AssemblyInfo[] — A list of assemblies and versions installed as part of this logger.
      - `name` string — The name of the assembly. This should include an assembly name like "Elmah.Io.NLog".
      - `version` string — The version of the assembly. This should include a SemVer string like "1.0.0.0".
    - `properties` Item[] — A list of properties for this logger.
      - `key` string — The key of the item.
      - `value` string — The value of the item.
    - `configFiles` ConfigFile[] — A list of config files, including their content, used to configure this logger.
      - `name` string — The name of the config file. Examples: appsettings.json, log4net.config, web.config.
      - `content` string — The content of the config file. This should at least include the content needed to configure the logger.
      - `contentType` string — The content type of the content in the file. The value of this field should be a valid MIME type like: application/xml, application/json.

## Response `200`

Installation was created.

## Other responses

- `400` — Model not valid.
- `401` — API key not valid or no access to resource.
- `404` — Specified log not found.
- `429` — A maximum of 500 requests per minute and 3600 requests per hour are permitted

---

[API](https://skmtc.net/elmah/apis/elmah-io-api.md) · [All operations](https://skmtc.net/elmah/apis/elmah-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elmah/elmah-io-api/versions/8e9c6e56e4fa/schema)