---
title: "Create an integration"
method: POST
path: "/integrations/create"
tags: ["Integrations"]
---

# Create an integration

`POST /integrations/create`

## Request

- Base URL: `https://api.spike.sh`
- URL: `https://api.spike.sh/integrations/create`
- Auth: none declared. Required headers: `x-api-key`, `x-team-id`
- TypeScript: <https://skmtc.dev/spike/apis/spike-sh-api/docs/integrations/create/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a new integration for a team

## Headers

- `x-api-key` string, required
- `x-team-id` string, required

## Request body

- object
  - `customName` string, required: Integration name
  - `desc` string: Integration description
  - `slug` string, required: Integration type slug
  - `escalation` string, required: Escalation ID
  - `service` string, required: Service ID
  - `repeatEscalation` boolean
  - `ackTimeout` integer: Acknowledge timeout in minutes

## Response `200`

Integration created successfully

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/spike/apis/spike-sh-api.md) - [All operations](https://skmtc.dev/spike/apis/spike-sh-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spike/apis/spike-sh-api/revisions/6854629119aa?raw)