---
title: "Changes to Create new subscription"
method: POST
path: "/subscriptions"
---

# Changes to Create new subscription

`POST /subscriptions`

> Every recorded change to this operation, newest first.
> 30 revisions in range; 1 not diffed.

## Timeline

Changed in 5 of 30 revisions.

- **2026-10-20** `530b6f7c74b4`: 1 info
- **2026-09-17** `8ad1c4416fb8`: 1 info
- **2026-08-25** `f49af9f7fc35`: 2 info
- **2026-08-20** `64746cdb0db4`: 5 info
- **2026-08-08** `222e6fad7c1f`: 2 breaking, 11 info

## Changes

- **2026-10-20** `530b6f7c74b4`: 1 info
  - added `subschema #3: Asset Change` to the request body `oneOf` list
- **2026-09-17** `8ad1c4416fb8`: 1 info
  - added `subschema #10: Location Change` to the request body `oneOf` list
- **2026-08-25** `f49af9f7fc35`: 2 info
  - added `subschema #5: Customer Change, subschema #14: New Customer` to the request body `oneOf` list
  - added the new `CUSTOMER` enum value to the request property `oneOf[subschema #41: Work Order Change -> subschema #43: Work Order Change]/filters/oneOfProperties/items/`
- **2026-08-20** `64746cdb0db4`: 5 info
  - added the new optional request property `oneOf[subschema #19: New Work Order]/options/includeOAuthTokensInPayload`
  - added the new optional request property `oneOf[subschema #24: Purchase Order Change]/options/includeOAuthTokensInPayload`
  - added the new optional request property `oneOf[subschema #25: Purchase Order Status Change]/options/includeOAuthTokensInPayload`
  - added the new optional request property `oneOf[subschema #41: Work Order Change]/options/includeOAuthTokensInPayload`
  - added the new optional request property `oneOf[subschema #42: Work Order Delete]/options/includeOAuthTokensInPayload`
- **2026-08-08** `222e6fad7c1f`: 2 breaking, 11 info
  - removed the media type `application/octet-stream` from the request body
  - removed `subschema #5: Purchase Order Overdue` from the request body `oneOf` list
  - added the new optional `header` request parameter `x-organization-id`
  - added the new optional `query` request parameter `skipWebhook`
  - added the new optional request property `oneOf[subschema #3: New Work Order -> subschema #19: New Work Order]/options`
  - added the new optional request property `oneOf[subschema #6: Purchase Order Status Change -> subschema #25: Purchase Order Status Change]/filters/vendors`
  - added the new optional request property `oneOf[subschema #6: Purchase Order Status Change -> subschema #25: Purchase Order Status Change]/options`
  - added the new optional request property `oneOf[subschema #8: Work Order Status Change -> subschema #45: Work Order Status Change]/options`
  - added `subschema #1: API Token Created, subschema #2: API Token Revoked, subschema #3: Asset Status Change, subschema #4: Connector Token Revoked, subschema #5: Data Export Initiated, subschema #6: Invite Link Archived, subschema #7: Invite Link Created, subschema #8: Invite Link Updated, subschema #10: New Asset, subschema #12: New Comment on Work Order, subschema #13: New Location, subschema #14: New Part, subschema #15: New Purchase Order, subschema #16: New Request, subschema #17: New Slash Command, subschema #18: New Vendor, subschema #20: Part Change, subschema #21: Part Delete, subschema #23: Part Transfer, subschema #24: Purchase Order Change, subschema #26: Role Archived, subschema #27: Role Created, subschema #28: Role Updated, subschema #29: SSO Configuration Changed, subschema #30: User Activated, subschema #31: User Invited, subschema #32: User Login Failure, subschema #33: User Login Success, subschema #34: User Logout, subschema #35: User Permissions Changed, subschema #36: User Removed, subschema #37: User Role Changed, subschema #38: User Session Revoked, subschema #39: Webhook Archived, subschema #40: Webhook Created, subschema #41: Work Order Change, subschema #42: Work Order Delete, subschema #44: Work Order Part Status Change, subschema #46: Work Request Status Change` to the request body `oneOf` list
  - added the new `CANCELED` enum value to the request property `oneOf[subschema #8: Work Order Status Change -> subschema #45: Work Order Status Change]/filters/oneOfStatuses/items/`
  - added the new `SKIPPED` enum value to the request property `oneOf[subschema #8: Work Order Status Change -> subschema #45: Work Order Status Change]/filters/oneOfStatuses/items/`
  - added the non-success response with the status `403`
  - added the optional property `secret` to the response with the `201` status

---

[Operation](https://skmtc.dev/getmaintainx/apis/maintainx-api/docs/subscriptions/post.md) - [API](https://skmtc.dev/getmaintainx/apis/maintainx-api.md) - [Page](https://skmtc.dev/getmaintainx/apis/maintainx-api/changes/subscriptions/post)