---
title: "POST /api/im/outbound"
method: POST
path: "/api/im/outbound"
tags: ["Im"]
---

# POST /api/im/outbound

`POST /api/im/outbound`

## Request

- Base URL: `https://uptimeify.io`
- URL: `https://uptimeify.io/api/im/outbound`
- Auth: HTTP bearer

## Request body

- object
  - `name` string, required
  - `type` 'slack' | 'teams' | 'discord' | 'jira' | 'pagerduty_v2' | 'opsgenie' | 'webhook', required
  - `config` object, required: Required per type: slack/teams/discord/webhook webhookUrl; jira email, apiToken, baseUrl, projectKey; pagerduty_v2 routingKey; opsgenie apiKey.
    - `webhookUrl` string
    - `bearerToken` string: webhook only.
    - `headers` object: webhook only.
    - `email` string: jira.
    - `apiToken` string: jira.
    - `baseUrl` string: jira, https only.
    - `projectKey` string: jira.
    - `routingKey` string: pagerduty_v2.
    - `apiKey` string: opsgenie.
  - `filters` object
    - `teams` integer[]: Only incidents of these teams.
    - `severities` string[]
    - `event_kinds` string[]: Default all; jira defaults to incident_created.
  - `teamId` integer, nullable: A team of your organization; null/absent = organization-wide.

## Response `200`

Successful response

- object
  - `id` integer, required
  - `organizationId` integer, required
  - `teamId` integer, nullable, required
  - `type` 'slack' | 'teams' | 'discord' | 'jira' | 'pagerduty_v2' | 'opsgenie' | 'webhook', required
  - `name` string, required
  - `config` object, required
    - `webhookUrl` unknown
    - `hasWebhookUrl` boolean
    - `bearerToken` unknown
    - `hasBearerToken` boolean
    - `headers` unknown
    - `hasHeaders` boolean
    - `email` string
    - `apiToken` unknown
    - `hasApiToken` boolean
    - `baseUrl` string
    - `projectKey` string
    - `routingKey` unknown
    - `hasRoutingKey` boolean
    - `apiKey` unknown
    - `hasApiKey` boolean
  - `filters` object, required
    - `teams` integer[]: Only incidents of these teams.
    - `severities` string[]
    - `event_kinds` string[]: Default all; jira defaults to incident_created.
  - `isActive` boolean, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400`: Invalid or missing parameters.
- `401`: Missing, invalid or expired API token.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api.md) · [All operations](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api/revisions/2129a771ee7e?raw)