---
title: "Create a subscription"
method: POST
path: "/gdc/projects/{project_id}/users/{profile_id}/subscriptions"
tags: ["subscriptions"]
---

# Create a subscription

`POST /gdc/projects/{project_id}/users/{profile_id}/subscriptions`

## Request

- Base URL: `https://secure.gooddata.com`
- URL: `https://secure.gooddata.com/gdc/projects/{project_id}/users/{profile_id}/subscriptions`
- Auth: none declared

## Path parameters

- `project_id` string, required
- `profile_id` string, required

## Request body

- Subscription1
  - `subscription` object, required
    - `triggers` union[], required
      - union
        - TimerEvent
          - `timerEvent` object, required
            - `cronExpression` string, required: cron expression
            - `timezone` string: timezone string as described in http://download.oracle.com/javase/1.4.2/docs/api/java/util/TimeZone.html
        - ProjectEventTrigger
          - `projectEventTrigger` object, required
            - `types` string[], required: types of events on which the subscription will be triggered.
    - `condition` SubscriptionCondition, required
      - `condition` object, required
        - `expression` string
    - `subject` object: subject is currently used only for email notifications
      - `template` object, required
        - `expression` string
    - `message` SubscriptionTemplate, required
      - `template` object, required
        - `expression` string
    - `channels` string[], required: array of notification channels
    - `disabled` union: Legacy boolean allowing boolean values represented by booleans or numbers
      - '0' | '1'
      - 0 | 1
      - boolean
    - `meta` MetaRequest, required
      - `title` string, required: Title of this metadata object. Mustn't contain only whitespace characters
      - `category` string: Category of this metadata object
      - `tags` string: List of tags for this metadata object separated by spaces
      - `author` string, uri: URI of the user's profile
      - `created` string: Date and time string in the format `YYYY-MM-DD hh:mm:ss`
      - `contributor` string, uri: URI of the user's profile
      - `updated` string: Date and time string in the format `YYYY-MM-DD hh:mm:ss`
      - `identifier` string: Global identifier of a metadata object
      - `flags` string[]: List of flags specified for this metadata object
      - `summary` string, nullable: A short description of this metadata object
      - `projectTemplate` string, uri
      - `uri` string, uri: Link to this metadata object
      - `deprecated` union: Legacy boolean allowing boolean values represented by booleans or numbers
        - '0' | '1'
        - 0 | 1
        - boolean
      - `locked` union: Legacy boolean allowing boolean values represented by booleans or numbers
        - '0' | '1'
        - 0 | 1
        - boolean
      - `unlisted` union: Legacy boolean allowing boolean values represented by booleans or numbers
        - '0' | '1'
        - 0 | 1
        - boolean
      - `isProduction` union: Legacy boolean allowing boolean values represented by booleans or numbers
        - '0' | '1'
        - 0 | 1
        - boolean
      - `sharedWithSomeone` union: Legacy boolean allowing boolean values represented by booleans or numbers
        - '0' | '1'
        - 0 | 1
        - boolean
    - `etlMonitoring` EtlMonitoring
      - `applyFor` object[]
        - `scope` string, required
        - `enabled` union: Legacy boolean allowing boolean values represented by booleans or numbers
          - '0' | '1'
          - 0 | 1
          - boolean

## Response `201`

_

- Subscription
  - `subscription` object, required
    - `triggers` union[], required
      - union
        - TimerEvent
          - `timerEvent` object, required
            - `cronExpression` string, required: cron expression
            - `timezone` string: timezone string as described in http://download.oracle.com/javase/1.4.2/docs/api/java/util/TimeZone.html
        - ProjectEventTrigger
          - `projectEventTrigger` object, required
            - `types` string[], required: types of events on which the subscription will be triggered.
    - `condition` SubscriptionCondition, required
      - `condition` object, required
        - `expression` string
    - `subject` object: subject is currently used only for email notifications
      - `template` object, required
        - `expression` string
    - `message` SubscriptionTemplate, required
      - `template` object, required
        - `expression` string
    - `channels` string[], required: array of notification channels
    - `disabled` union: Legacy boolean allowing boolean values represented by booleans or numbers
      - '0' | '1'
      - 0 | 1
      - boolean
    - `meta` MetaResponse, required
      - `title` string, required: Title of this metadata object. Mustn't contain only whitespace characters
      - `category` string: Category of this metadata object
      - `tags` string: List of tags for this metadata object separated by spaces
      - `author` string, uri: URI of the user's profile
      - `created` string: Date and time string in the format `YYYY-MM-DD hh:mm:ss`
      - `contributor` string, uri: URI of the user's profile
      - `updated` string: Date and time string in the format `YYYY-MM-DD hh:mm:ss`
      - `identifier` string: Global identifier of a metadata object
      - `flags` string[]: List of flags specified for this metadata object
      - `summary` string: A short description of this metadata object
      - `uri` string: Link to this metadata object
      - `deprecated` '0' | '1': Flag that the metadata object is deprecated
      - `locked` 0 | 1: Flag that the metadata object is locked
      - `unlisted` 0 | 1: Flag that the metadata object is unlisted
      - `isProduction` 0 | 1: Flag that the metadata object is production
      - `sharedWithSomeone` 0 | 1: Is the linked object shared with someone via ACLs?
    - `etlMonitoring` EtlMonitoring
      - `applyFor` object[]
        - `scope` string, required
        - `enabled` union: Legacy boolean allowing boolean values represented by booleans or numbers
          - '0' | '1'
          - 0 | 1
          - boolean

---

[API](https://skmtc.dev/gooddata/apis/gooddata-api-documentation.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-api-documentation/revisions/e5dc0ee6ab00?raw)