---
title: "Changes to Create an integration"
method: POST
path: "/v1/integrations"
---

# Changes to Create an integration

`POST /v1/integrations`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 20 revisions.

- **2026-11-01** `172526226f1d`: 2 info
- **2026-09-03** `26726df52d97`: 4 info
- **2026-08-28** `16a345244098`: 2 info
- **2026-08-16** `c2b2fa0d5d48`: 2 info
- **2026-07-31** `8092e41edd57`: 1 info
- **2026-07-21** `c69777f60184`: 1 warning, 3 info

## Changes

- **2026-11-01** `172526226f1d`: 2 info
  - added the new optional request property `credentials/allOf[#/components/schemas/CredentialsDto]/authMethod`
  - added the optional property `credentials/allOf[#/components/schemas/CredentialsDto]/authMethod` to the response with the `201` status
- **2026-09-03** `26726df52d97`: 4 info
  - added the new optional request property `rules`
  - request property `conditions` deprecated
  - added the optional property `rules` to the response with the `201` status
  - response property `conditions` deprecated
- **2026-08-28** `16a345244098`: 2 info
  - added the new optional request property `credentials/allOf[#/components/schemas/CredentialsDto]/hmacSecretKeyEncoding`
  - added the optional property `credentials/allOf[#/components/schemas/CredentialsDto]/hmacSecretKeyEncoding` to the response with the `201` status
- **2026-08-16** `c2b2fa0d5d48`: 2 info
  - added the new optional request property `credentials/allOf[#/components/schemas/CredentialsDto]/configurationSetName`
  - added the optional property `credentials/allOf[#/components/schemas/CredentialsDto]/configurationSetName` to the response with the `201` status
- **2026-07-31** `8092e41edd57`: 1 info
  - added the optional property `configurations/allOf[#/components/schemas/ConfigurationsDto]/payloadSchema` to the response with the `201` status
- **2026-07-21** `c69777f60184`: 1 warning, 3 info
  - added the new `tool` enum value to the `channel` response property for the response status `201`
  - added the new optional request property `credentials/allOf[#/components/schemas/CredentialsDto]/whatsNextCompletedAt`
  - added the new `tool` enum value to the request property `channel`
  - added the optional property `credentials/allOf[#/components/schemas/CredentialsDto]/whatsNextCompletedAt` to the response with the `201` status

---

[Operation](https://skmtc.dev/novu/apis/novu-api/docs/v1/integrations/post.md) - [API](https://skmtc.dev/novu/apis/novu-api.md) - [Page](https://skmtc.dev/novu/apis/novu-api/changes/v1/integrations/post)