--- title: "Update IntegrationCredentials" method: PUT path: "/organizations/{orgId}/integrationcredentials/{id}" tags: ["IntegrationCredentials"] --- # Update IntegrationCredentials `PUT /organizations/{orgId}/integrationcredentials/{id}` ## Request - Base URL: `https://api.m3ter.com` - URL: `https://api.m3ter.com/organizations/{orgId}/integrationcredentials/{id}` - Auth: OAuth 2 - Authorization code: `https://m3ter.auth.us-east-1.amazoncognito.com/oauth2/authorize`, token URL `https://m3ter.auth.us-east-1.amazoncognito.com/oauth2/token` - Client credentials, token URL `/oauth/token` - TypeScript: (a function with typed inputs; its response is checked against the schema) Updated the integration credentials for the UUID ## Path parameters - `orgId` string, required - `id` string, required ## Request body - 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. ## Response `200` Return the IntegrationCredentials - union - IntegrationNetsuiteCredentialsResponse - `accountId` string: Netsuite account ID. - `certificateId` string: m3ter certificate ID - `clientId` string: Netsuite integration client ID - `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. - `type` string, required: the type of credentials - `destination` string, required: the system the integration is for - `destinationId` string: the destinationId the integration is for - `name` string: the name of the credentials - IntegrationChargebeeCredentialsResponse - `apiKey` string - `site` string - `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. - `type` string, required: the type of credentials - `destination` string, required: the system the integration is for - `destinationId` string: the destinationId the integration is for - `name` string: the name of the credentials - IntegrationBasicCredentialsResponse - `username` string - `password` string - `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. - `type` string, required: the type of credentials - `destination` string, required: the system the integration is for - `destinationId` string: the destinationId the integration is for - `name` string: the name of the credentials - IntegrationClientCredentialsRequest: Request representing a credential set for oauth2, the client credentials flow - `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. - `empty` boolean - `type` 'OAUTH_CLIENT_CREDENTIALS', required - `name` string: The name of the credentials - `destination` 'WEBHOOK' | 'NETSUITE' | 'STRIPE' | 'STRIPE_TEST' | 'AWS' | 'PADDLE' | 'PADDLE_SANDBOX' | 'SALESFORCE' | 'XERO' | 'CHARGEBEE' | 'QUICKBOOKS' | 'QUICKBOOKS_SANDBOX' | 'M3TER' - `externalCustomerId` string, required - `clientId` string, required - `keyId` string, required - IntegrationPaddleCredentialsResponse - `apiKey` string - `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. - `type` string, required: the type of credentials - `destination` string, required: the system the integration is for - `destinationId` string: the destinationId the integration is for - `name` string: the name of the credentials - IntegrationM3terSignedCredentialsResponse - `apiKey` string: The API key provided by m3ter. This key is part of the credential set required for signing requests and authenticating with m3ter services. - `secret` string: The secret associated with the API key. This secret is used in conjunction with the API key to generate a signature for secure authentication. - `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. - `type` string, required: the type of credentials - `destination` string, required: the system the integration is for - `destinationId` string: the destinationId the integration is for - `name` string: the name of the credentials - IntegrationAWSCredentialsResponse - `accountId` string: the ID of the AWS account - `roleName` string: the name of the role that m3ter will assume to interact with resources in the AWS account - `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. - `type` string, required: the type of credentials - `destination` string, required: the system the integration is for - `destinationId` string: the destinationId the integration is for - `name` string: the name of the credentials - IntegrationOAuthCodeCredentialsResponse: Request representing a credential set for oauth code auth - `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. - `type` string, required: the type of credentials - `destination` string, required: the system the integration is for - `destinationId` string: the destinationId the integration is for - `name` string: the name of the credentials - IntegrationStripeSignedCredentialsResponse - `signingKey` string: the public key from a Stripe webhook that can be used to authenticate an inbound request. - `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. - `type` string, required: the type of credentials - `destination` string, required: the system the integration is for - `destinationId` string: the destinationId the integration is for - `name` string: the name of the credentials - IntegrationSapBydCredentialsResponse - `hostname` string - `username` string - `password` string - `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. - `type` string, required: the type of credentials - `destination` string, required: the system the integration is for - `destinationId` string: the destinationId the integration is for - `name` string: the name of the credentials - IntegrationHubspotClientSecretResponse - `accessToken` string - `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. - `type` string, required: the type of credentials - `destination` string, required: the system the integration is for - `destinationId` string: the destinationId the integration is for - `name` string: the name of the credentials - IntegrationSageIntacctClientCredentialsResponse - `clientId` string - `clientSecret` string - `userId` string - `companyId` string - `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. - `type` string, required: the type of credentials - `destination` string, required: the system the integration is for - `destinationId` string: the destinationId the integration is for - `name` string: the name of the credentials - IntegrationSageIntacctClientSecretResponse - `clientSecret` string - `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. - `type` string, required: the type of credentials - `destination` string, required: the system the integration is for - `destinationId` string: the destinationId the integration is for - `name` string: the name of the credentials - IntegrationStaticApiKeyCredentialsResponse: Response containing a response for a credential using a static API key - `empty` boolean: A flag to indicate whether the credentials are empty. * TRUE - empty credentials. * FALSE - credential details required. - `type` 'HTTP_BASIC' | 'OAUTH_CLIENT_CREDENTIALS' | 'M3TER_SIGNED_REQUEST' | 'AWS_INTEGRATION' | 'PADDLE_AUTH' | 'NETSUITE_AUTH' | 'CHARGEBEE_AUTH' | 'M3TER_APP_SIGNATURE' | 'M3TER_SERVICE_USER' | 'STRIPE_SIGNED_REQUEST' | 'HUBSPOT_ACCESS_TOKEN' | 'HUBSPOT_CLIENT_SECRET' | 'OPSGENIE_KEY' | 'SAP_BYD' | 'SLACK_WEBHOOK' | 'SAGE_INTACCT_CLIENT_CREDENTIALS' | 'SAGE_INTACCT_CLIENT_SECRET' | 'STATIC_API_KEY' | 'GCP_WIF' | 'SNS_REQUEST', required: the type of credentials - `name` string: the name of the credentials - `destination` 'WEBHOOK' | 'NETSUITE' | 'STRIPE' | 'STRIPE_TEST' | 'AWS' | 'PADDLE' | 'PADDLE_SANDBOX' | 'SALESFORCE' | 'XERO' | 'CHARGEBEE' | 'QUICKBOOKS' | 'QUICKBOOKS_SANDBOX' | 'M3TER', required: the system the integration is for - `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. - `id` string, required: The UUID of the entity. - `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. - `destinationId` string: the destinationId the integration is for - `apiKey` string - IntegrationGcpCredentialsResponse - `projectNumber` string: GCP Project number - `wifPoolId` string: the ID of the workforce identity pool - `providerId` string: the ID of the provider within the workforce identity pool - `gcpServiceAccountEmail` string: the email of the GCP service account to impersonate when using workload identity federation - `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. - `type` string, required: the type of credentials - `destination` string, required: the system the integration is for - `destinationId` string: the destinationId the integration is for - `name` string: the name of the credentials ## Other responses - `4XX`: Error message - `5XX`: Error message ## Changes - **2026-10-16** `85c514abc692`: 1 info - endpoint added [Operation history](https://skmtc.dev/m3ter-com/apis/m3ter-api/changes/organizations/:orgId/integrationcredentials/: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.dev/m3ter-com/apis/m3ter-api/revisions/85c514abc692?raw)