v1
ApplicationAPI & CLI
Double column
API
CLI
JS Client

Integrations /

Create notification integration

Create a new notification integration.

Required permission

Account > Team > Notifications > Manage

Path parameters

    • notificationId

      string required
      ID of the notification integration

Request body

  • {object}

    • name

      string required
      The name of the notification integration.
      min length
      3
      max length
      39
      pattern
      ^[a-zA-Z]((-|\s)?[a-zA-Z0-9]+((-|\s)[a-zA-Z0-9]+)*)?$

    • type

      string required
      The provider to send webhooks to. `RAW_WEBHOOK` allows you to send webhooks to a url of your choice, or you can choose a specific provider.
      one of
      RAW_WEBHOOK, DISCORD, TEAMS

    • webhook

      string required
      The URL where webhooks will be sent.

    • secret

      string
      An optional secret that will be sent in the webhook header for verification. Supports `RAW_WEBHOOK` only.

    • restricted

      boolean
      Should notifications be sent only for specific projects?

    • projects

      [array]
      An array of projects that notifications will be sent for.
      • string
        pattern
        ^[A-Za-z0-9-]+$

    • events

      {object} required
      Which events should notifications be sent for?

      • trigger:service:autoscaling:event

        boolean

      • trigger:service:deployment:status-update

        boolean

      • trigger:addon-backup:start

        boolean

      • trigger:addon-backup:success

        boolean

      • trigger:addon-backup:failure

        boolean

      • trigger:addon-backup:abort

        boolean

      • trigger:build:start

        boolean

      • trigger:build:success

        boolean

      • trigger:build:failure

        boolean

      • trigger:build:abort

        boolean

      • trigger:job-run:start

        boolean

      • trigger:job-run:success

        boolean

      • trigger:job-run:failure

        boolean

      • trigger:job-run:abort

        boolean

      • trigger:job-run:terminate

        boolean

      • trigger:release-flow-template-run:start

        boolean

      • trigger:release-flow-template-run:update

        boolean

      • trigger:release-flow-template-run:success

        boolean

      • trigger:release-flow-template-run:failure

        boolean

      • trigger:release-flow-template-run:aborted

        boolean

      • trigger:template-run:queued

        boolean

      • trigger:template-run:start

        boolean

      • trigger:template-run:update

        boolean

      • trigger:template-run:success

        boolean

      • trigger:template-run:failure

        boolean

      • trigger:resource:certificate-success

        boolean

      • trigger:resource:certificate-final-failure

        boolean

      • trigger:cdn:action-success

        boolean

      • trigger:cdn:action-failure

        boolean

      • trigger:cdn:action-delay

        boolean

      • trigger:log-sink:paused

        boolean

      • trigger:billing:billing-alert-exceeded

        boolean

      • trigger:billing:invoice-payment-action-required

        boolean

      • trigger:billing:invoice-payment-failed

        boolean

      • trigger:billing:invoice-paid

        boolean

      • trigger:billing:invoice-carried-over

        boolean

      • trigger:infrastructure:service:container-crash

        boolean

      • trigger:infrastructure:service:container-eviction

        boolean

      • trigger:infrastructure:addon:container-crash

        boolean

      • trigger:infrastructure:addon:container-eviction

        boolean

      • trigger:infrastructure:job:container-crash

        boolean

      • trigger:infrastructure:job:container-eviction

        boolean

      • trigger:infrastructure:service:container-cpuSpike90

        boolean

      • trigger:infrastructure:service:container-cpuSustained90

        boolean

      • trigger:infrastructure:job:container-cpuSpike90

        boolean

      • trigger:infrastructure:job:container-cpuSustained90

        boolean

      • trigger:infrastructure:addon:container-cpuSpike90

        boolean

      • trigger:infrastructure:addon:container-cpuSustained90

        boolean

      • trigger:infrastructure:service:container-memorySpike90

        boolean

      • trigger:infrastructure:service:container-memorySustained90

        boolean

      • trigger:infrastructure:job:container-memorySpike90

        boolean

      • trigger:infrastructure:job:container-memorySustained90

        boolean

      • trigger:infrastructure:addon-volume:usage-75-exceeded

        boolean

      • trigger:infrastructure:addon-volume:usage-90-exceeded

        boolean

      • trigger:infrastructure:platform-volume:usage-75-exceeded

        boolean

      • trigger:infrastructure:platform-volume:usage-90-exceeded

        boolean

      • trigger:infrastructure:byoc:cluster:error

        boolean

      • trigger:infrastructure:byoc:node-pool:error

        boolean

      • trigger:infrastructure:byoc:scheduling:error

        boolean

Response body

  • {object}
    Response object.

    • data

      {object} required
      Result data.

      • name

        string required
        The name of the notification integration.
        min length
        3
        max length
        39
        pattern
        ^[a-zA-Z]((-|\s)?[a-zA-Z0-9]+((-|\s)[a-zA-Z0-9]+)*)?$

      • id

        string required
        The ID of the notification integration.

      • type

        string required
        The provider to send webhooks to. `RAW_WEBHOOK` allows you to send webhooks to a url of your choice, or you can choose a specific provider.
        one of
        RAW_WEBHOOK, SLACK, DISCORD, TEAMS

      • webhook

        string required
        The URL where webhooks will be sent.

      • createdAt

        string required
        Creation date

      • updatedAt

        string required
        Last update date

      • status

        {object}

        • disabled

          boolean
          Is the webhook currently disabled?

        • reason

          boolean
          Why the webhook was disabled.

        • timeOfFirstFailedRequest

          string
          The timestamp of the first failed webhook request.

        • numberOfFailedRequests

          number
          The number of failed webhook requests.

      • restricted

        boolean required
        Should notifications be sent only for specific projects?

      • projects

        [array] required
        An array of projects that notifications will be sent for.
        • string
          pattern
          ^[A-Za-z0-9-]+$

      • events

        {object} required
        Which events should notifications be sent for?

        • trigger:service:autoscaling:event

          boolean

        • trigger:service:deployment:status-update

          boolean

        • trigger:addon-backup:start

          boolean

        • trigger:addon-backup:success

          boolean

        • trigger:addon-backup:failure

          boolean

        • trigger:addon-backup:abort

          boolean

        • trigger:build:start

          boolean

        • trigger:build:success

          boolean

        • trigger:build:failure

          boolean

        • trigger:build:abort

          boolean

        • trigger:job-run:start

          boolean

        • trigger:job-run:success

          boolean

        • trigger:job-run:failure

          boolean

        • trigger:job-run:abort

          boolean

        • trigger:job-run:terminate

          boolean

        • trigger:release-flow-template-run:start

          boolean

        • trigger:release-flow-template-run:update

          boolean

        • trigger:release-flow-template-run:success

          boolean

        • trigger:release-flow-template-run:failure

          boolean

        • trigger:release-flow-template-run:aborted

          boolean

        • trigger:template-run:queued

          boolean

        • trigger:template-run:start

          boolean

        • trigger:template-run:update

          boolean

        • trigger:template-run:success

          boolean

        • trigger:template-run:failure

          boolean

        • trigger:resource:certificate-success

          boolean

        • trigger:resource:certificate-final-failure

          boolean

        • trigger:cdn:action-success

          boolean

        • trigger:cdn:action-failure

          boolean

        • trigger:cdn:action-delay

          boolean

        • trigger:log-sink:paused

          boolean

        • trigger:billing:billing-alert-exceeded

          boolean

        • trigger:billing:invoice-payment-action-required

          boolean

        • trigger:billing:invoice-payment-failed

          boolean

        • trigger:billing:invoice-paid

          boolean

        • trigger:billing:invoice-carried-over

          boolean

        • trigger:infrastructure:service:container-crash

          boolean

        • trigger:infrastructure:service:container-eviction

          boolean

        • trigger:infrastructure:addon:container-crash

          boolean

        • trigger:infrastructure:addon:container-eviction

          boolean

        • trigger:infrastructure:job:container-crash

          boolean

        • trigger:infrastructure:job:container-eviction

          boolean

        • trigger:infrastructure:service:container-cpuSpike90

          boolean

        • trigger:infrastructure:service:container-cpuSustained90

          boolean

        • trigger:infrastructure:job:container-cpuSpike90

          boolean

        • trigger:infrastructure:job:container-cpuSustained90

          boolean

        • trigger:infrastructure:addon:container-cpuSpike90

          boolean

        • trigger:infrastructure:addon:container-cpuSustained90

          boolean

        • trigger:infrastructure:service:container-memorySpike90

          boolean

        • trigger:infrastructure:service:container-memorySustained90

          boolean

        • trigger:infrastructure:job:container-memorySpike90

          boolean

        • trigger:infrastructure:job:container-memorySustained90

          boolean

        • trigger:infrastructure:addon-volume:usage-75-exceeded

          boolean

        • trigger:infrastructure:addon-volume:usage-90-exceeded

          boolean

        • trigger:infrastructure:platform-volume:usage-75-exceeded

          boolean

        • trigger:infrastructure:platform-volume:usage-90-exceeded

          boolean

        • trigger:infrastructure:byoc:cluster:error

          boolean

        • trigger:infrastructure:byoc:node-pool:error

          boolean

        • trigger:infrastructure:byoc:scheduling:error

          boolean
API
CLI
JS Client

POST /v1/integrations/notifications

Example request

Request body
curl
curl --header "Content-Type: application/json" \
  --header "Authorization: Bearer NORTHFLANK_API_TOKEN" \
  --request POST \
  --data '{"name":"Example Notification","type":"RAW_WEBHOOK","webhook":"https://example.com/webhooks","restricted":true,"projects":["default-project"],"events":{"trigger:service:autoscaling:event":true,"trigger:service:deployment:status-update":true,"trigger:addon-backup:start":true,"trigger:addon-backup:success":true,"trigger:addon-backup:failure":true,"trigger:addon-backup:abort":true,"trigger:build:start":true,"trigger:build:success":true,"trigger:build:failure":true,"trigger:build:abort":true,"trigger:job-run:start":true,"trigger:job-run:success":true,"trigger:job-run:failure":true,"trigger:job-run:abort":true,"trigger:job-run:terminate":true,"trigger:release-flow-template-run:start":true,"trigger:release-flow-template-run:update":true,"trigger:release-flow-template-run:success":true,"trigger:release-flow-template-run:failure":true,"trigger:release-flow-template-run:aborted":true,"trigger:template-run:queued":true,"trigger:template-run:start":true,"trigger:template-run:update":true,"trigger:template-run:success":true,"trigger:template-run:failure":true,"trigger:resource:certificate-success":true,"trigger:resource:certificate-final-failure":true,"trigger:cdn:action-success":true,"trigger:cdn:action-failure":true,"trigger:cdn:action-delay":true,"trigger:log-sink:paused":true,"trigger:billing:billing-alert-exceeded":true,"trigger:billing:invoice-payment-action-required":true,"trigger:billing:invoice-payment-failed":true,"trigger:billing:invoice-paid":true,"trigger:billing:invoice-carried-over":true,"trigger:infrastructure:service:container-crash":true,"trigger:infrastructure:service:container-eviction":true,"trigger:infrastructure:addon:container-crash":true,"trigger:infrastructure:addon:container-eviction":true,"trigger:infrastructure:job:container-crash":true,"trigger:infrastructure:job:container-eviction":true,"trigger:infrastructure:service:container-cpuSpike90":true,"trigger:infrastructure:service:container-cpuSustained90":true,"trigger:infrastructure:job:container-cpuSpike90":true,"trigger:infrastructure:job:container-cpuSustained90":true,"trigger:infrastructure:addon:container-cpuSpike90":true,"trigger:infrastructure:addon:container-cpuSustained90":true,"trigger:infrastructure:service:container-memorySpike90":true,"trigger:infrastructure:service:container-memorySustained90":true,"trigger:infrastructure:job:container-memorySpike90":true,"trigger:infrastructure:job:container-memorySustained90":true,"trigger:infrastructure:addon-volume:usage-75-exceeded":true,"trigger:infrastructure:addon-volume:usage-90-exceeded":true,"trigger:infrastructure:platform-volume:usage-75-exceeded":true,"trigger:infrastructure:platform-volume:usage-90-exceeded":true,"trigger:infrastructure:byoc:cluster:error":true,"trigger:infrastructure:byoc:node-pool:error":true,"trigger:infrastructure:byoc:scheduling:error":true}}' \
  https://api.northflank.com/v1/integrations/notifications

Example response

200 OK

Details of a notification integration

JSON

{
  "data": {
    "name": "Example Notification",
    "id": "example-notification",
    "type": "RAW_WEBHOOK",
    "webhook": "https://example.com/webhooks",
    "createdAt": "2023-09-12T16:39:44.166Z\"",
    "updatedAt": "2023-09-12T16:39:44.166Z\"",
    "status": {
      "disabled": false
    },
    "restricted": true,
    "projects": [
      "default-project"
    ],
    "events": {
      "trigger:service:autoscaling:event": true,
      "trigger:service:deployment:status-update": true,
      "trigger:addon-backup:start": true,
      "trigger:addon-backup:success": true,
      "trigger:addon-backup:failure": true,
      "trigger:addon-backup:abort": true,
      "trigger:build:start": true,
      "trigger:build:success": true,
      "trigger:build:failure": true,
      "trigger:build:abort": true,
      "trigger:job-run:start": true,
      "trigger:job-run:success": true,
      "trigger:job-run:failure": true,
      "trigger:job-run:abort": true,
      "trigger:job-run:terminate": true,
      "trigger:release-flow-template-run:start": true,
      "trigger:release-flow-template-run:update": true,
      "trigger:release-flow-template-run:success": true,
      "trigger:release-flow-template-run:failure": true,
      "trigger:release-flow-template-run:aborted": true,
      "trigger:template-run:queued": true,
      "trigger:template-run:start": true,
      "trigger:template-run:update": true,
      "trigger:template-run:success": true,
      "trigger:template-run:failure": true,
      "trigger:resource:certificate-success": true,
      "trigger:resource:certificate-final-failure": true,
      "trigger:cdn:action-success": true,
      "trigger:cdn:action-failure": true,
      "trigger:cdn:action-delay": true,
      "trigger:log-sink:paused": true,
      "trigger:billing:billing-alert-exceeded": true,
      "trigger:billing:invoice-payment-action-required": true,
      "trigger:billing:invoice-payment-failed": true,
      "trigger:billing:invoice-paid": true,
      "trigger:billing:invoice-carried-over": true,
      "trigger:infrastructure:service:container-crash": true,
      "trigger:infrastructure:service:container-eviction": true,
      "trigger:infrastructure:addon:container-crash": true,
      "trigger:infrastructure:addon:container-eviction": true,
      "trigger:infrastructure:job:container-crash": true,
      "trigger:infrastructure:job:container-eviction": true,
      "trigger:infrastructure:service:container-cpuSpike90": true,
      "trigger:infrastructure:service:container-cpuSustained90": true,
      "trigger:infrastructure:job:container-cpuSpike90": true,
      "trigger:infrastructure:job:container-cpuSustained90": true,
      "trigger:infrastructure:addon:container-cpuSpike90": true,
      "trigger:infrastructure:addon:container-cpuSustained90": true,
      "trigger:infrastructure:service:container-memorySpike90": true,
      "trigger:infrastructure:service:container-memorySustained90": true,
      "trigger:infrastructure:job:container-memorySpike90": true,
      "trigger:infrastructure:job:container-memorySustained90": true,
      "trigger:infrastructure:addon-volume:usage-75-exceeded": true,
      "trigger:infrastructure:addon-volume:usage-90-exceeded": true,
      "trigger:infrastructure:platform-volume:usage-75-exceeded": true,
      "trigger:infrastructure:platform-volume:usage-90-exceeded": true,
      "trigger:infrastructure:byoc:cluster:error": true,
      "trigger:infrastructure:byoc:node-pool:error": true,
      "trigger:infrastructure:byoc:scheduling:error": true
    }
  }
}

© 2024 Northflank Ltd. All rights reserved.

northflank.comTermsPrivacyfeedback@northflank.com