---
title: "Update IntegrationConfig"
method: PUT
path: "/organizations/{orgId}/integrationconfigs/{id}"
tags: ["Integrations"]
---

# Update IntegrationConfig

`PUT /organizations/{orgId}/integrationconfigs/{id}`

Update the integration configuration for the given UUID.

This endpoint allows you to update the configuration of a specific integration within your organization. It is used to modify settings or parameters of an existing integration.

## Path parameters

- `orgId` string, required
- `id` string, required

## Request body

- IntegrationConfigRequest
  - `version` integer — The version number of the entity: - **Create entity:** Not valid for initial insertion of new entity - *do not use for Create*. On initial Create, version is set at 1 and listed in the response. - **Update Entity:** On Update, version is required and must match the existing version because a check is performed to ensure sequential versioning is preserved. Version is incremented by 1 and listed in the response.
  - `entityType` string, required — Specifies the type of entity for which the integration configuration is being updated. Must be a valid alphanumeric string.
  - `entityId` string — The unique identifier (UUID) of the entity. This field is used to specify which entity's integration configuration you're updating.
  - `destination` string, required — Denotes the integration destination. This field identifies the target platform or service for the integration.
  - `destinationId` string — The unique identifier (UUID) for the integration destination.
  - `configData` object — A flexible object to include any additional configuration data specific to the integration.
  - `credentials` IntegrationCredentialsRequestBase
    - `version` integer — The version number of the entity: - **Create entity:** Not valid for initial insertion of new entity - *do not use for Create*. On initial Create, version is set at 1 and listed in the response. - **Update Entity:** On Update, version is required and must match the existing version because a check is performed to ensure sequential versioning is preserved. Version is incremented by 1 and listed in the response.
  - `integrationCredentialsId` string
  - `name` string

## Response `200`

Returns the IntegrationConfig

- IntegrationConfigResponse — Response containing a IntegrationConfigResponse entity
  - `id` string, required — The UUID of the entity.
  - `version` integer — The version number: - **Create:** On initial Create to insert a new entity, the version is set at 1 in the response. - **Update:** On successful Update, the version is incremented by 1 in the response.
  - `dtCreated` string, date-time — The DateTime when this item was created *(in ISO-8601 format)*.
  - `dtLastModified` string, date-time — The DateTime when this item was last modified *(in ISO-8601 format)*.
  - `createdBy` string — The ID of the user who created this item.
  - `lastModifiedBy` string — The ID of the user who last modified this item.
  - `entityType` string, required — The type of entity the integration is for *(e.g. Bill)*.
  - `entityId` string — The unique identifier (UUID) of the entity this integration is for *(e.g. the ID of a notification configuration. Optional.)*
  - `destination` string, required — The type of destination *(e.g. Netsuite, webhooks)*.
  - `destinationId` string — The unique identifier (UUID) of the entity the integration is for.
  - `configData` object — Configuration data for the integration
  - `authorized` boolean — A flag indicating whether the integration configuration is authorized. * TRUE - authorized. * FALSE - not authorized.
  - `enabled` boolean — A flag indicating whether the integration configuration is currently enabled or disabled. * TRUE - enabled. * FALSE - disabled.
  - `triggerType` 'EVENT' | 'SCHEDULE' — Specifies the type of trigger for the integration.
  - `integrationCredentialsId` string — UUID of the credentials to use for this integration
  - `name` string — The name of the configuration

## Other responses

- `4XX` — Error message
- `5XX` — Error message

## Changes

- **2025-12-03** `ac93d1a9e6d9` — 3 info
  - added the new `M3TER_APP_SIGNATURE` enum value to the request property `allOf[subschema #2]/credentials/type`
  - added the new `SAGE_INTACCT_CLIENT_CREDENTIALS` enum value to the request property `allOf[subschema #2]/credentials/type`
  - added the new `SLACK_WEBHOOK` enum value to the request property `allOf[subschema #2]/credentials/type`
- **2025-08-29** `0f92c877619f` — 4 breaking, 10 info
  - added `subschema #1, subschema #2` to the `allOf[subschema #2]/configData` request property `allOf` list
  - the `allOf[subschema #2]/configData` request property type/format changed from `object`/`` to ``/``
  - removed the required property `allOf[subschema #3]/id` from the response with the `200` status
  - removed the required property `allOf[subschema #3]/version` from the response with the `200` status
  - …10 more
- **2025-08-01** `9f9e5f3dbde7` — 2 breaking
  - the response property `allOf[#/components/schemas/AbstractResponseWithAuditFields]/allOf[#/components/schemas/AbstractResponse]/version` became optional for the status `200`
  - the response property `allOf[#/components/schemas/AbstractResponse]/version` became optional for the status `200`
- **2025-02-04** `9433593378b5` — 1 info
  - added the new `STRIPE_SIGNED_REQUEST` enum value to the request property `allOf[subschema #2]/credentials/type`

[Change history](https://skmtc.dev/m3ter-com/apis/m3ter-api/changes/organizations/:orgId/integrationconfigs/:id/put.md)

---

[API](https://skmtc.dev/m3ter-com/apis/m3ter-api.md) · [All operations](https://skmtc.dev/m3ter-com/apis/m3ter-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/m3ter-com/m3ter-api/revisions/ac93d1a9e6d9/schema)