Bulk Upsert Records
curl --request POST \
--url https://app.superleap.com/api/v1/org/objects/{object_slug}/record/bulk_upsert \
--header 'Authorization: <authorization>' \
--header 'Content-Type: <content-type>'import requests
url = "https://app.superleap.com/api/v1/org/objects/{object_slug}/record/bulk_upsert"
headers = {
"Authorization": "<authorization>",
"Content-Type": "<content-type>"
}
response = requests.post(url, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<authorization>', 'Content-Type': '<content-type>'}
};
fetch('https://app.superleap.com/api/v1/org/objects/{object_slug}/record/bulk_upsert', 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://app.superleap.com/api/v1/org/objects/{object_slug}/record/bulk_upsert",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"Content-Type: <content-type>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.superleap.com/api/v1/org/objects/{object_slug}/record/bulk_upsert"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "<authorization>")
req.Header.Add("Content-Type", "<content-type>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.superleap.com/api/v1/org/objects/{object_slug}/record/bulk_upsert")
.header("Authorization", "<authorization>")
.header("Content-Type", "<content-type>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.superleap.com/api/v1/org/objects/{object_slug}/record/bulk_upsert")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = '<content-type>'
response = http.request(request)
puts response.read_bodyRecord Management APIs
Bulk Upsert Records
POST
/
api
/
v1
/
org
/
objects
/
{object_slug}
/
record
/
bulk_upsert
Bulk Upsert Records
curl --request POST \
--url https://app.superleap.com/api/v1/org/objects/{object_slug}/record/bulk_upsert \
--header 'Authorization: <authorization>' \
--header 'Content-Type: <content-type>'import requests
url = "https://app.superleap.com/api/v1/org/objects/{object_slug}/record/bulk_upsert"
headers = {
"Authorization": "<authorization>",
"Content-Type": "<content-type>"
}
response = requests.post(url, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<authorization>', 'Content-Type': '<content-type>'}
};
fetch('https://app.superleap.com/api/v1/org/objects/{object_slug}/record/bulk_upsert', 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://app.superleap.com/api/v1/org/objects/{object_slug}/record/bulk_upsert",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"Content-Type: <content-type>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.superleap.com/api/v1/org/objects/{object_slug}/record/bulk_upsert"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "<authorization>")
req.Header.Add("Content-Type", "<content-type>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.superleap.com/api/v1/org/objects/{object_slug}/record/bulk_upsert")
.header("Authorization", "<authorization>")
.header("Content-Type", "<content-type>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.superleap.com/api/v1/org/objects/{object_slug}/record/bulk_upsert")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = '<content-type>'
response = http.request(request)
puts response.read_bodyBulk upsert multiple records for a requested object in a single API call. This API is useful when you need to insert or update multiple records efficiently, reducing the number of API calls required.
Headers
string
required
Bearer token for authentication, click here to generate one
string
default:"application/json"
required
application/json
Path Parameters
string
required
The slug identifier for the object type you want to filter (e.g., “lead”, “user”, “opportunity”)
Example Request
curl --location 'https://app.superleap.dev/api/v1/org/objects/lead/record/bulk_upsert' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer OGEWZMJJMTGTNZEYZS0ZYTG3LTLKMMETY2I3MDDJNJKXMMM4' \
--data-raw '{
"values": [
{
"name": "testAdmin",
"email": "test@gmail.com"
},
{
"id": "g1koYv_2lLKYVan",
"name": "testSteve"
}
]
}'
Example
Request
curl --location 'https://app.superleap.dev/api/v1/org/objects/lead/record/bulk_upsert' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer OGEWZMJJMTGTNZEYZS0ZYTG3LTLKMMETY2I3MDDJNJKXMMM4' \
--data-raw '{
"values": [
{
"name": "testAdmin",
"email": "test@gmail.com"
},
{
"id": "g1koYv_2lLKYVan",
"name": "testSteve"
}
]
}'
Response 200 OK
{
"success": true,
"data": {
"records_created": 1,
"records_updated": 1,
"failed_records": null,
"created_records": [
{
"action": "CREATED",
"created_at": 1753948409620,
"created_by": "g1koYv_BkJ851eS",
"email": "test@gmail.com",
"id": "g1koYv_NmlNtQT1",
"multiselect_1": [
"op3"
],
"name": "testAdmin",
"object_id": "g1koYv_EAobj2SH",
"org_id": "g1koYv",
"owner": "g1koYv_BkJ851eS",
"search_field": "testAdmin",
"system_created_at": 1753948409624,
"updated_at": 1753948409620,
"updated_by": "g1koYv_BkJ851eS"
}
],
"updated_records": [
{
"action": "UPDATED",
"id": "g1koYv_2lLKYVan",
"name": "testSteve",
"object_id": "g1koYv_EAobj2SH",
"org_id": "g1koYv",
"search_field": "testSteve",
"updated_at": 1753948409668,
"updated_by": "g1koYv_BkJ851eS"
}
],
"records": [
{
"action": "CREATED",
"created_at": 1753948409620,
"created_by": "g1koYv_BkJ851eS",
"email": "test@gmail.com",
"id": "g1koYv_NmlNtQT1",
"multiselect_1": [
"op3"
],
"name": "testAdmin",
"object_id": "g1koYv_EAobj2SH",
"org_id": "g1koYv",
"owner": "g1koYv_BkJ851eS",
"search_field": "testAdmin",
"system_created_at": 1753948409624,
"updated_at": 1753948409620,
"updated_by": "g1koYv_BkJ851eS"
},
{
"action": "UPDATED",
"id": "g1koYv_2lLKYVan",
"name": "testSteve",
"object_id": "g1koYv_EAobj2SH",
"org_id": "g1koYv",
"search_field": "testSteve",
"updated_at": 1753948409668,
"updated_by": "g1koYv_BkJ851eS"
}
]
}
}
Request for Failure Scenario
This example demonstrates how the API handles validation errors when the input data is not in the correct formatcurl --location 'https://app.superleap.dev/api/v1/org/objects/lead/record/bulk_upsert' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer OGEWZMJJMTGTNZEYZS0ZYTG3LTLKMMETY2I3MDDJNJKXMMM4' \
--data-raw '{
"values": [
{
"name": "testssse",
"email": "test@gmail.com"
},
{
"id": "OAASbQ_Ph9vneRS",
"name": "testsssdfsdfse"
}
]
}'
Response 200 OK
Failures are returned in the response, allowing you to handle them appropriately.{
"success": true,
"data": {
"records_created": 1,
"records_updated": 0,
"failed_records": [
{
"action": "FAILED",
"error_message": "invalid id detected : OAASbQ_Ph9vneRS",
"id": "OAASbQ_Ph9vneRS",
"name": "testsssdfsdfse"
}
],
"created_records": [
{
"action": "CREATED",
"created_at": 1753948287965,
"created_by": "g1koYv_BkJ851eS",
"email": "test@gmail.com",
"id": "g1koYv_y3msyauq",
"multiselect_1": [
"op3"
],
"name": "testssse",
"object_id": "g1koYv_EAobj2SH",
"org_id": "g1koYv",
"owner": "g1koYv_BkJ851eS",
"search_field": "testssse",
"system_created_at": 1753948287970,
"updated_at": 1753948287965,
"updated_by": "g1koYv_BkJ851eS"
}
],
"updated_records": null,
"records": [
{
"action": "CREATED",
"created_at": 1753948287965,
"created_by": "g1koYv_BkJ851eS",
"email": "test@gmail.com",
"id": "g1koYv_y3msyauq",
"multiselect_1": [
"op3"
],
"name": "testssse",
"object_id": "g1koYv_EAobj2SH",
"org_id": "g1koYv",
"owner": "g1koYv_BkJ851eS",
"search_field": "testssse",
"system_created_at": 1753948287970,
"updated_at": 1753948287965,
"updated_by": "g1koYv_BkJ851eS"
},
{
"action": "FAILED",
"error_message": "invalid id detected : OAASbQ_Ph9vneRS",
"id": "OAASbQ_Ph9vneRS",
"name": "testsssdfsdfse"
}
]
}
}
⌘I