curl --request POST \
--url https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'x-api-key: <api-key>' \
--data '
{
"contact": {
"id": "4e362e2b-67b2-4a7e-a9df-e9ecf9141be8",
"phone": "+573001234567",
"email": "john.doe@example.com"
},
"pipelineId": "5d0b8f8e-3c1a-4a4e-9a57-2f6f3e1c9b10",
"stageId": "stage-new",
"name": "Acme renewal 2027",
"externalId": "ERP-OPP-981",
"values": {
"budget": 15000000,
"closeDate": "2026-12-15",
"segment": "Retail"
}
}
'import requests
url = "https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records"
payload = {
"contact": {
"id": "4e362e2b-67b2-4a7e-a9df-e9ecf9141be8",
"phone": "+573001234567",
"email": "john.doe@example.com"
},
"pipelineId": "5d0b8f8e-3c1a-4a4e-9a57-2f6f3e1c9b10",
"stageId": "stage-new",
"name": "Acme renewal 2027",
"externalId": "ERP-OPP-981",
"values": {
"budget": 15000000,
"closeDate": "2026-12-15",
"segment": "Retail"
}
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
'x-api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
contact: {
id: '4e362e2b-67b2-4a7e-a9df-e9ecf9141be8',
phone: '+573001234567',
email: 'john.doe@example.com'
},
pipelineId: '5d0b8f8e-3c1a-4a4e-9a57-2f6f3e1c9b10',
stageId: 'stage-new',
name: 'Acme renewal 2027',
externalId: 'ERP-OPP-981',
values: {budget: 15000000, closeDate: '2026-12-15', segment: 'Retail'}
})
};
fetch('https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'contact' => [
'id' => '4e362e2b-67b2-4a7e-a9df-e9ecf9141be8',
'phone' => '+573001234567',
'email' => 'john.doe@example.com'
],
'pipelineId' => '5d0b8f8e-3c1a-4a4e-9a57-2f6f3e1c9b10',
'stageId' => 'stage-new',
'name' => 'Acme renewal 2027',
'externalId' => 'ERP-OPP-981',
'values' => [
'budget' => 15000000,
'closeDate' => '2026-12-15',
'segment' => 'Retail'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records"
payload := strings.NewReader("{\n \"contact\": {\n \"id\": \"4e362e2b-67b2-4a7e-a9df-e9ecf9141be8\",\n \"phone\": \"+573001234567\",\n \"email\": \"john.doe@example.com\"\n },\n \"pipelineId\": \"5d0b8f8e-3c1a-4a4e-9a57-2f6f3e1c9b10\",\n \"stageId\": \"stage-new\",\n \"name\": \"Acme renewal 2027\",\n \"externalId\": \"ERP-OPP-981\",\n \"values\": {\n \"budget\": 15000000,\n \"closeDate\": \"2026-12-15\",\n \"segment\": \"Retail\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records")
.header("Idempotency-Key", "<idempotency-key>")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"contact\": {\n \"id\": \"4e362e2b-67b2-4a7e-a9df-e9ecf9141be8\",\n \"phone\": \"+573001234567\",\n \"email\": \"john.doe@example.com\"\n },\n \"pipelineId\": \"5d0b8f8e-3c1a-4a4e-9a57-2f6f3e1c9b10\",\n \"stageId\": \"stage-new\",\n \"name\": \"Acme renewal 2027\",\n \"externalId\": \"ERP-OPP-981\",\n \"values\": {\n \"budget\": 15000000,\n \"closeDate\": \"2026-12-15\",\n \"segment\": \"Retail\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"contact\": {\n \"id\": \"4e362e2b-67b2-4a7e-a9df-e9ecf9141be8\",\n \"phone\": \"+573001234567\",\n \"email\": \"john.doe@example.com\"\n },\n \"pipelineId\": \"5d0b8f8e-3c1a-4a4e-9a57-2f6f3e1c9b10\",\n \"stageId\": \"stage-new\",\n \"name\": \"Acme renewal 2027\",\n \"externalId\": \"ERP-OPP-981\",\n \"values\": {\n \"budget\": 15000000,\n \"closeDate\": \"2026-12-15\",\n \"segment\": \"Retail\"\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "0d3c7f0e-5a43-5c0e-9f53-1f6a4b2e7d11",
"pipelineId": "5d0b8f8e-3c1a-4a4e-9a57-2f6f3e1c9b10",
"pipelineVersion": 3,
"stageId": "stage-new",
"state": "OPEN",
"name": "Acme renewal 2027",
"contact": {
"id": "4e362e2b-67b2-4a7e-a9df-e9ecf9141be8"
},
"source": "API",
"revision": 1,
"createdAt": "2026-11-11T15:00:00.000Z",
"updatedAt": "2026-11-11T15:00:00.000Z",
"values": {
"budget": 15000000,
"closeDate": "2026-12-15"
},
"ownerId": null,
"externalId": "ERP-OPP-981",
"closeReason": {
"id": "reason-price",
"label": "Price too high",
"note": null
},
"closedAt": null
}Crear un registro de pipeline
Crea un registro de un contacto en un pipeline, como una oportunidad de venta.
El contacto se indica con exactamente uno de id, phone o email y debe existir: nunca se crea (404
BRIDGE_EXTERNAL_0001). pipelineId toma por defecto el pipeline predeterminado del workspace y stageId la
etapa inicial del pipeline. Un name ausente o vacío toma por defecto el nombre completo del contacto, luego su
celular y luego su correo electrónico. Solo se aceptan etapas abiertas, y solo atributos de alcance RECORD de la
versión actual del pipeline en values (un null, un texto vacío o una lista vacía se omite); cada problema
encontrado se lista en extra.errors del 422
BRIDGE_PIPELINE_0311. Cuando la etapa en la que empieza el registro exige un contacto completo (nombre, apellido,
celular y cada atributo personalizado obligatorio del workspace), uno incompleto falla con 422
BRIDGE_PIPELINE_0305, cuyo extra.missing indica lo que le falta. Un segundo registro con el mismo externalId
en el pipeline falla con 409 BRIDGE_PIPELINE_0003, cuyo extra.recordId es el registro existente.
Idempotency-Key es obligatorio. Reintentar con la misma clave y el mismo cuerpo responde 201 con el primer registro y
Idempotent-Replayed: true. La misma clave con un cuerpo distinto falla con 422 BRIDGE_PIPELINE_0402, y
mientras la primera solicitud sigue en curso, con 409 BRIDGE_PIPELINE_0401. Cuando la solicitud falla, la clave se
libera y puede reintentarse. Si la primera solicitud se cortó antes de terminar, su clave sigue respondiendo 409
BRIDGE_PIPELINE_0401 hasta por 24 horas: reintenta con una clave nueva y envía externalId para que un reintento nunca
cree un segundo registro.
curl --request POST \
--url https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'x-api-key: <api-key>' \
--data '
{
"contact": {
"id": "4e362e2b-67b2-4a7e-a9df-e9ecf9141be8",
"phone": "+573001234567",
"email": "john.doe@example.com"
},
"pipelineId": "5d0b8f8e-3c1a-4a4e-9a57-2f6f3e1c9b10",
"stageId": "stage-new",
"name": "Acme renewal 2027",
"externalId": "ERP-OPP-981",
"values": {
"budget": 15000000,
"closeDate": "2026-12-15",
"segment": "Retail"
}
}
'import requests
url = "https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records"
payload = {
"contact": {
"id": "4e362e2b-67b2-4a7e-a9df-e9ecf9141be8",
"phone": "+573001234567",
"email": "john.doe@example.com"
},
"pipelineId": "5d0b8f8e-3c1a-4a4e-9a57-2f6f3e1c9b10",
"stageId": "stage-new",
"name": "Acme renewal 2027",
"externalId": "ERP-OPP-981",
"values": {
"budget": 15000000,
"closeDate": "2026-12-15",
"segment": "Retail"
}
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
'x-api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
contact: {
id: '4e362e2b-67b2-4a7e-a9df-e9ecf9141be8',
phone: '+573001234567',
email: 'john.doe@example.com'
},
pipelineId: '5d0b8f8e-3c1a-4a4e-9a57-2f6f3e1c9b10',
stageId: 'stage-new',
name: 'Acme renewal 2027',
externalId: 'ERP-OPP-981',
values: {budget: 15000000, closeDate: '2026-12-15', segment: 'Retail'}
})
};
fetch('https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'contact' => [
'id' => '4e362e2b-67b2-4a7e-a9df-e9ecf9141be8',
'phone' => '+573001234567',
'email' => 'john.doe@example.com'
],
'pipelineId' => '5d0b8f8e-3c1a-4a4e-9a57-2f6f3e1c9b10',
'stageId' => 'stage-new',
'name' => 'Acme renewal 2027',
'externalId' => 'ERP-OPP-981',
'values' => [
'budget' => 15000000,
'closeDate' => '2026-12-15',
'segment' => 'Retail'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records"
payload := strings.NewReader("{\n \"contact\": {\n \"id\": \"4e362e2b-67b2-4a7e-a9df-e9ecf9141be8\",\n \"phone\": \"+573001234567\",\n \"email\": \"john.doe@example.com\"\n },\n \"pipelineId\": \"5d0b8f8e-3c1a-4a4e-9a57-2f6f3e1c9b10\",\n \"stageId\": \"stage-new\",\n \"name\": \"Acme renewal 2027\",\n \"externalId\": \"ERP-OPP-981\",\n \"values\": {\n \"budget\": 15000000,\n \"closeDate\": \"2026-12-15\",\n \"segment\": \"Retail\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records")
.header("Idempotency-Key", "<idempotency-key>")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"contact\": {\n \"id\": \"4e362e2b-67b2-4a7e-a9df-e9ecf9141be8\",\n \"phone\": \"+573001234567\",\n \"email\": \"john.doe@example.com\"\n },\n \"pipelineId\": \"5d0b8f8e-3c1a-4a4e-9a57-2f6f3e1c9b10\",\n \"stageId\": \"stage-new\",\n \"name\": \"Acme renewal 2027\",\n \"externalId\": \"ERP-OPP-981\",\n \"values\": {\n \"budget\": 15000000,\n \"closeDate\": \"2026-12-15\",\n \"segment\": \"Retail\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"contact\": {\n \"id\": \"4e362e2b-67b2-4a7e-a9df-e9ecf9141be8\",\n \"phone\": \"+573001234567\",\n \"email\": \"john.doe@example.com\"\n },\n \"pipelineId\": \"5d0b8f8e-3c1a-4a4e-9a57-2f6f3e1c9b10\",\n \"stageId\": \"stage-new\",\n \"name\": \"Acme renewal 2027\",\n \"externalId\": \"ERP-OPP-981\",\n \"values\": {\n \"budget\": 15000000,\n \"closeDate\": \"2026-12-15\",\n \"segment\": \"Retail\"\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "0d3c7f0e-5a43-5c0e-9f53-1f6a4b2e7d11",
"pipelineId": "5d0b8f8e-3c1a-4a4e-9a57-2f6f3e1c9b10",
"pipelineVersion": 3,
"stageId": "stage-new",
"state": "OPEN",
"name": "Acme renewal 2027",
"contact": {
"id": "4e362e2b-67b2-4a7e-a9df-e9ecf9141be8"
},
"source": "API",
"revision": 1,
"createdAt": "2026-11-11T15:00:00.000Z",
"updatedAt": "2026-11-11T15:00:00.000Z",
"values": {
"budget": 15000000,
"closeDate": "2026-12-15"
},
"ownerId": null,
"externalId": "ERP-OPP-981",
"closeReason": {
"id": "reason-price",
"label": "Price too high",
"note": null
},
"closedAt": null
}Encabezados
Una clave que eliges por cada registro a crear, como el id de operación de tu sistema. Envía la misma clave cuando reintentes la solicitud: durante 24 horas responde con el registro que creó la primera solicitud.
1 - 255"erp-opp-981-create"
Parámetros de ruta
Cuerpo
Cuerpo de la solicitud para crear un registro de pipeline.
Valores de los atributos del registro, indexados por id de atributo. Solo se aceptan atributos de alcance RECORD de la versión actual del pipeline, cada uno validado según su tipo (TEXT hasta 2000 caracteres); un valor null, un texto vacío y una lista vacía se omiten.
{
"budget": 15000000,
"closeDate": "2026-12-15",
"segment": "Retail"
}
Respuesta
El registro se creó, o lo creó una solicitud anterior con la misma clave.
Un registro de un pipeline, como una oportunidad de venta de un contacto.
¿Esta página le ayudó?

