Skip to main content
POST
Create integration

Authorizations

app_key
string
query
required

App key issued from the Flashduty console under Account → APP Keys. Required on every public API call. Keep it secret — it grants the same access as the owning account.

Body

application/json

Payload for creating an integration.

plugin_type
string
required

Integration type. Must be one listed by POST /integration/type/list with supports_api_create: true.

Example:

"standard.alert"

name
string

Integration name. 2–49 characters.

Required string length: 2 - 49
Example:

"Prod metrics alerts"

description
string

Free-form description, at most 499 characters.

Maximum string length: 499
team_id
integer<int64>

Owning team ID.

Required range: x >= 1
Example:

1467226103121

settings
object

Type-specific configuration; the accepted keys depend on plugin_type.

Response

Success

Success response envelope. On every 2xx response, request_id identifies the call (also mirrored in the Flashcat-Request-Id header) and data holds the endpoint-specific payload. Failure responses use a different shape — see ErrorResponse.

request_id
string
required

Unique ID for this request. Mirrored in the Flashcat-Request-Id response header. Include it when reporting issues.

Example:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object
required

The created integration and its key.