---
title: "Create a new continuous pipeline"
method: POST
path: "/v1/integration/continuous/pipelines"
tags: ["Build and Configure Continuous Integration Projects"]
---

# Create a new continuous pipeline

`POST /v1/integration/continuous/pipelines`

## Request

- Base URL: `https://integration-adapter.connect.cloud.precisely.com`
- URL: `https://integration-adapter.connect.cloud.precisely.com/v1/integration/continuous/pipelines`
- Auth: HTTP bearer

Creates a new continuous data integration pipeline with specified configuration parameters.

**Process Overview:**
1. **Project Verification** - Validates or creates the specified project
2. **Pipeline Creation** - Creates the pipeline with provided configuration
3. **Configuration Application** - Applies data flow type and properties
4. **Validation & Persistence** - Validates and saves the complete configuration

**Supported Pipeline Types:**
- `COPY` - One-time data copy operation
- `REPLICATE` - Continuous data replication
- `SYNCHRONIZE` - Bidirectional data synchronization
- `AUDIT` - Data audit and compliance tracking

**Required Permissions:** `replication-pipeline::create` when permission harmonization is enabled; otherwise, `replication-pipeline::manage`.

## Request body

- CreateContinuousPipelineRequest: Request payload for creating a new Continuous Replication Pipeline in the Data Integration Project
  - `projectName` string: The name of the project that will contain this replication pipeline. A project contains a collection of replication pipelines.
  - `pipelineName` string: The name of the replication pipeline to be created. A replication pipeline is a collection of data transfer tasks that filters and transfers data to a specified target.
  - `description` string, required: Description of the replication pipeline
  - `pipelineType` 'SYNCHRONIZE' | 'REPLICATE' | 'COPY' | 'AUDIT', required: The type of replication pipeline. Can be COPY (one-time copy), REPLICATE (continuous replication), SYNCHRONIZE (copy then replicate) or AUDIT (auditing data changes)
  - `properties` object: Additional configuration properties for the replication pipeline, such as row filters, settings, or process-specific options

## Response `201`

Pipeline successfully created and configured

- CreateContinuousPipelineResponse: Response containing the created pipeline's details
  - `projectId` string: ID of the project containing the pipeline. This is the project that was either found or created during the pipeline creation process.
  - `pipelineId` string: ID of the created pipeline. This identifier can be used to query the pipeline status, modify its configuration, or manage its lifecycle.

## Other responses

- `400`: Bad Request - Validation failed due to one of the following reasons: - Invalid project name format - Invalid pipeline name format - Invalid or unsupported pipeline type - Invalid configuration properties
- `401`: Unauthorized - Authentication required, valid credentials not provided
- `403`: Forbidden - User lacks the required 'replication-pipeline::create' or legacy 'replication-pipeline::manage' permission
- `409`: Conflict - A resource with the same identifier already exists. This may occur in scenarios such as: - Pipeline with the specified name already exists within the project
- `422`: Unprocessable Entity - Request is syntactically correct but semantically invalid: - Pipeline configuration conflicts with existing pipeline in the same project - Business rule violations in pipeline configuration - Resource conflicts or constraints violations
- `500`: Internal Server Error - Server encountered an unexpected condition, such as: - Project creation failure (ProjectUpsertFailedException) - Project retrieval failure (ProjectsRetrievalFailedException) - Pipeline creation failure (PipelineUpsertFailedException) - Service unavailability - Internal processing failures

---

[API](https://skmtc.dev/precisely/apis/precisely-integration-adapter-service.md) · [All operations](https://skmtc.dev/precisely/apis/precisely-integration-adapter-service/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/precisely-integration-adapter-service/revisions/2d2629f4987d?raw)