---
title: "Create one reusable encrypted Integration and its first read action"
method: POST
path: "/v1/integrations"
---

# Create one reusable encrypted Integration and its first read action

`POST /v1/integrations`

## Request

- Base URL: `https://api.skysay.ai`
- URL: `https://api.skysay.ai/v1/integrations`
- Auth: none declared

The signing secret is accepted only in this request and is never returned. The required initial_action makes the setup atomic; no saved Integration exists without an allowed action.

## Request body

- object
  - `endpoint_url` string, uri, required
  - `initial_action` object, required: A read-only action with name, input_schema, output_schema, description, and timeout_seconds.
  - `name` string, required
  - `organization_id` string, required
  - `project_id` string, required
  - `signing_secret` string, required

## Response `201`

Safe Integration and initial action metadata

---

[API](https://skmtc.dev/skysay/apis/skysay-api.md) · [All operations](https://skmtc.dev/skysay/apis/skysay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skysay/apis/skysay-api/revisions/148c7e111260?raw)