---
title: "Add a record to a pipeline"
method: POST
path: "/pipelines/{pipelineId}/entries"
tags: ["Pipelines"]
---

# Add a record to a pipeline

`POST /pipelines/{pipelineId}/entries`

Add a company or contact to a pipeline. `recordId` is the Gleap id of the record — a
company's `_id` (see GET /companies) or a contact's `id`, matching the pipeline's
`recordType`. `laneId` picks the stage and defaults to the pipeline's first stage; `values`
sets initial field values keyed by `fieldId` (see GET /pipelines/{pipelineId}/properties).

A record sits on a pipeline at most once: adding one that is already present returns the
existing entry unchanged instead of creating a duplicate. Pipeline automations configured for
"record added" run on a genuine add.

## Path parameters

- `pipelineId` string, required

## Headers

- `project` string, required

## Request body

- PipelineEntryDTO
  - `recordId` string, required — Gleap id of the record to add, matching the pipeline's `recordType`: a company's `_id` (see GET /companies) or a contact's `id`. Not your own external companyId / userId.
  - `laneId` string — Stage to add the entry to — a lane `id` from the pipeline's `lanes`. Defaults to the pipeline's first stage.
  - `values` unknown

## Response `200`

Ok

- object
  - `updatedAt` string, required
  - `createdAt` string, required
  - `laneChangedAt` string, date-time
  - `recordSnapshot` object
    - `subtitle` string
    - `plan` string
    - `externalId` string
    - `value` number, double
    - `name` string
  - `laneId` string
  - `dueDate` string, date-time
  - `lexorank` string
  - `createdBy` object
    - `isValid` object
    - `createFromHexString` object
    - `createFromTime` object
    - `generate` object
    - `cacheHexString` unknown
    - `prototype` string
  - `recordId` object, required
    - `isValid` object
    - `createFromHexString` object
    - `createFromTime` object
    - `generate` object
    - `cacheHexString` unknown
    - `prototype` string
  - `recordType` 'COMPANY' | 'CONTACT', required
  - `pipeline` object, required
    - `isValid` object
    - `createFromHexString` object
    - `createFromTime` object
    - `generate` object
    - `cacheHexString` unknown
    - `prototype` string
  - `project` object, required
    - `isValid` object
    - `createFromHexString` object
    - `createFromTime` object
    - `generate` object
    - `cacheHexString` unknown
    - `prototype` string
  - `values` unknown, required
  - `_id` string, required

---

[API](https://skmtc.net/gleap/apis/gleap-server.md) · [All operations](https://skmtc.net/gleap/apis/gleap-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gleap/gleap-server/revisions/93af2e90fb6a/schema)