---
title: "Creates a new Subscription"
method: POST
path: "/spaces/{spaceIdentifier}/subscriptions"
tags: ["Subscriptions"]
---

# Creates a new Subscription

`POST /spaces/{spaceIdentifier}/subscriptions`

## Path parameters

- `spaceIdentifier` string, required

## Request body

- CreateSubscriptionCommand
  - `EventNotificationSubscription` EventNotificationSubscriptionResource, required
    - `EmailDigestLastProcessed` string, date-time
    - `EmailDigestLastProcessedEventAutoId` integer
    - `EmailFrequencyPeriod` string, date-span
    - `EmailPriority` 'Normal' | 'Low' | 'High'
    - `EmailShowDatesInTimeZoneId` string
    - `EmailTeams` string[]
    - `Filter` EventNotificationSubscriptionFilterResource
      - `DocumentTypes` string[]
      - `Environments` string[]
      - `EventAgents` string[]
      - `EventCategories` string[]
      - `EventGroups` string[]
      - `ProjectGroups` string[]
      - `Projects` string[]
      - `Tags` string[]
      - `Tenants` string[]
      - `Users` string[]
    - `SlackChannelIds` string[]
    - `SlackChannelNames` string[]
    - `SlackDigestLastProcessed` string, date-time
    - `SlackDigestLastProcessedEventAutoId` integer
    - `SlackFrequencyPeriod` string, date-span
    - `WebhookHeaderKey` string
    - `WebhookHeaderValue` PropertyValueResource
      - `IsSensitive` boolean
      - `SensitiveValue` SensitiveValue
        - `HasValue` boolean
        - `Hint` string
        - `NewValue` string
      - `Value` string
    - `WebhookLastProcessed` string, date-time
    - `WebhookLastProcessedEventAutoId` integer
    - `WebhookTeams` string[]
    - `WebhookTimeout` string, date-span
    - `WebhookURI` string, uri
  - `IsDisabled` boolean
  - `Name` string, required
  - `SpaceId` string, required

## Response `201`

Created

- SubscriptionResource
  - `EventNotificationSubscription` EventNotificationSubscriptionResource
    - `EmailDigestLastProcessed` string, date-time
    - `EmailDigestLastProcessedEventAutoId` integer
    - `EmailFrequencyPeriod` string, date-span
    - `EmailPriority` 'Normal' | 'Low' | 'High'
    - `EmailShowDatesInTimeZoneId` string
    - `EmailTeams` string[]
    - `Filter` EventNotificationSubscriptionFilterResource
      - `DocumentTypes` string[]
      - `Environments` string[]
      - `EventAgents` string[]
      - `EventCategories` string[]
      - `EventGroups` string[]
      - `ProjectGroups` string[]
      - `Projects` string[]
      - `Tags` string[]
      - `Tenants` string[]
      - `Users` string[]
    - `SlackChannelIds` string[]
    - `SlackChannelNames` string[]
    - `SlackDigestLastProcessed` string, date-time
    - `SlackDigestLastProcessedEventAutoId` integer
    - `SlackFrequencyPeriod` string, date-span
    - `WebhookHeaderKey` string
    - `WebhookHeaderValue` PropertyValueResource
      - `IsSensitive` boolean
      - `SensitiveValue` SensitiveValue
        - `HasValue` boolean
        - `Hint` string
        - `NewValue` string
      - `Value` string
    - `WebhookLastProcessed` string, date-time
    - `WebhookLastProcessedEventAutoId` integer
    - `WebhookTeams` string[]
    - `WebhookTimeout` string, date-span
    - `WebhookURI` string, uri
  - `Id` string
  - `IsDisabled` boolean
  - `LastModifiedBy` string
  - `LastModifiedOn` string, date-time
  - `Links` object
  - `Name` string
  - `SpaceId` string
  - `Type` 'Event'

## Other responses

- `400` — Bad request. Either the payload was not structurally valid or business rules did not permit the operation.
- `404` — Not found. One or more of the entities involved in the operation was not found.

---

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