---
title: "Create an Integration"
method: POST
path: "/environments/{envId}/integrations"
tags: ["Integrations"]
---

# Create an Integration

`POST /environments/{envId}/integrations`

Create an Integration

Create a new Integration. The response body will not contain Agent Status. To get it you should use getIntegration operation.

## Request body

- CreateIntegration
  - `name` string, required — Name of the integration
  - `description` string — Description of the integration
  - `provider` string, required — Provider of this integration (use "A2A" for A2A integrations)
  - `wellKnownUrls` IntegrationWellKnownUrl[] — A2A well-known URLs (only for A2A provider)
    - `url` string — URL for well-known endpoint

## Response `201`

Integration successfully created

- Integration
  - `id` string — Id of the integration
  - `name` string — Name of the integration
  - `description` string — Description of the integration
  - `provider` string — Provider of this integration
  - `primaryOwner` PrimaryOwner
    - `id` string — Owner's uuid.
    - `email` string — Owner's email. Can be null if owner is a group.
    - `displayName` string — Owner's name.
    - `type` 'USER' | 'GROUP' — The type of membership
  - `groups` string[] — A list of group ids
  - `agentStatus` 'CONNECTED' | 'DISCONNECTED' — Agent connection status (not for A2A)
  - `pendingJob` IngestionJob
    - `id` string — Id of the ingestion job
    - `startedAt` string, date-time — The last datetime when the job was started.
    - `status` 'SUCCESS' | 'PENDING' | 'ERROR' | 'TIMEOUT' — Status of the job.
  - `wellKnownUrls` IntegrationWellKnownUrl[] — A2A well-known URLs (only for A2A provider)
    - `url` string — URL for well-known endpoint

## Other responses

- `default` — Generic error response

---

[API](https://skmtc.net/gravitee-io/apis/gravitee-io-apim-management-api-apis.md) · [All operations](https://skmtc.net/gravitee-io/apis/gravitee-io-apim-management-api-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gravitee-io/gravitee-io-apim-management-api-apis/versions/aef12fc964d5/schema)