---
title: "setIntegrationAppMapping"
method: PUT
path: "/v1/integrations/{integrationId}/app-mapping"
tags: ["integrations"]
---

# setIntegrationAppMapping

`PUT /v1/integrations/{integrationId}/app-mapping`

Creates or updates a mapping from an app/component to an integration.
This allows ERP updates sent via app_id and component_id to be associated
with a specific integration configuration.

## Path parameters

- `integrationId` string, uuid, required

## Request body

- SetIntegrationAppMappingRequest
  - `app_id` string, uuid, required — UUID of the integration app instance
  - `component_id` string, uuid, required — UUID of the integration app component instance
  - `overwrite` boolean — If true, overwrites existing mapping. If false and mapping exists, returns 409 Conflict.

## Response `200`

App mapping set successfully

- IntegrationAppMapping
  - `integration_id` string, uuid, required — The integration ID this app/component is mapped to

## Other responses

- `400` — Bad request
- `401` — Unauthorized request
- `404` — Integration not found
- `409` — Mapping already exists (use overwrite=true to replace)
- `500` — Internal Server Error

---

[API](https://skmtc.net/epilot/apis/integration-toolkit-api.md) · [All operations](https://skmtc.net/epilot/apis/integration-toolkit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/epilot/integration-toolkit-api/revisions/c24837d75096/schema)