---
title: "Create IntegrationConfig"
method: POST
path: "/organizations/{orgId}/integrationconfigs"
tags: ["Integrations"]
---

# Create IntegrationConfig

`POST /organizations/{orgId}/integrationconfigs`

Set the integration configuration for the entity.

## Path parameters

- `orgId` 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

---

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