Update up to 100 opportunities, each with its own values
curl --request POST \
--url https://api.statisfy.com/v1/objects/opportunity/records/batch/update \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"items": [
{
"id": "<string>",
"amount": null,
"close_date": null,
"description": null,
"fields": {},
"name": null,
"owner": null,
"stage": null,
"type": null
}
]
}
'import requests
url = "https://api.statisfy.com/v1/objects/opportunity/records/batch/update"
payload = { "items": [
{
"id": "<string>",
"amount": None,
"close_date": None,
"description": None,
"fields": {},
"name": None,
"owner": None,
"stage": None,
"type": None
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
items: [
{
id: '<string>',
amount: null,
close_date: null,
description: null,
fields: {},
name: null,
owner: null,
stage: null,
type: null
}
]
})
};
fetch('https://api.statisfy.com/v1/objects/opportunity/records/batch/update', 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.statisfy.com/v1/objects/opportunity/records/batch/update",
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([
'items' => [
[
'id' => '<string>',
'amount' => null,
'close_date' => null,
'description' => null,
'fields' => [
],
'name' => null,
'owner' => null,
'stage' => null,
'type' => null
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.statisfy.com/v1/objects/opportunity/records/batch/update"
payload := strings.NewReader("{\n \"items\": [\n {\n \"id\": \"<string>\",\n \"amount\": null,\n \"close_date\": null,\n \"description\": null,\n \"fields\": {},\n \"name\": null,\n \"owner\": null,\n \"stage\": null,\n \"type\": null\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.statisfy.com/v1/objects/opportunity/records/batch/update")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"items\": [\n {\n \"id\": \"<string>\",\n \"amount\": null,\n \"close_date\": null,\n \"description\": null,\n \"fields\": {},\n \"name\": null,\n \"owner\": null,\n \"stage\": null,\n \"type\": null\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.statisfy.com/v1/objects/opportunity/records/batch/update")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"items\": [\n {\n \"id\": \"<string>\",\n \"amount\": null,\n \"close_date\": null,\n \"description\": null,\n \"fields\": {},\n \"name\": null,\n \"owner\": null,\n \"stage\": null,\n \"type\": null\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"items": [
{
"id": "<string>",
"status": "updated",
"error": {
"code": "<string>",
"message": "<string>",
"details": [
{}
]
}
}
]
}opportunities
Update up to 100 opportunities, each with its own values
items is up to 100 updates, each an opportunity id and an update body. Each is checked and written on its own, so one failure does not stop the rest. The answer lists every item in request order with status updated or failed, and for a failure the error a single update would have returned. As with a single update, a failed item may be partly written (custom values commit before standard fields). It counts as one write per item against your rate limit.
POST
/
v1
/
objects
/
opportunity
/
records
/
batch
/
update
Update up to 100 opportunities, each with its own values
curl --request POST \
--url https://api.statisfy.com/v1/objects/opportunity/records/batch/update \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"items": [
{
"id": "<string>",
"amount": null,
"close_date": null,
"description": null,
"fields": {},
"name": null,
"owner": null,
"stage": null,
"type": null
}
]
}
'import requests
url = "https://api.statisfy.com/v1/objects/opportunity/records/batch/update"
payload = { "items": [
{
"id": "<string>",
"amount": None,
"close_date": None,
"description": None,
"fields": {},
"name": None,
"owner": None,
"stage": None,
"type": None
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
items: [
{
id: '<string>',
amount: null,
close_date: null,
description: null,
fields: {},
name: null,
owner: null,
stage: null,
type: null
}
]
})
};
fetch('https://api.statisfy.com/v1/objects/opportunity/records/batch/update', 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.statisfy.com/v1/objects/opportunity/records/batch/update",
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([
'items' => [
[
'id' => '<string>',
'amount' => null,
'close_date' => null,
'description' => null,
'fields' => [
],
'name' => null,
'owner' => null,
'stage' => null,
'type' => null
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.statisfy.com/v1/objects/opportunity/records/batch/update"
payload := strings.NewReader("{\n \"items\": [\n {\n \"id\": \"<string>\",\n \"amount\": null,\n \"close_date\": null,\n \"description\": null,\n \"fields\": {},\n \"name\": null,\n \"owner\": null,\n \"stage\": null,\n \"type\": null\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.statisfy.com/v1/objects/opportunity/records/batch/update")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"items\": [\n {\n \"id\": \"<string>\",\n \"amount\": null,\n \"close_date\": null,\n \"description\": null,\n \"fields\": {},\n \"name\": null,\n \"owner\": null,\n \"stage\": null,\n \"type\": null\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.statisfy.com/v1/objects/opportunity/records/batch/update")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"items\": [\n {\n \"id\": \"<string>\",\n \"amount\": null,\n \"close_date\": null,\n \"description\": null,\n \"fields\": {},\n \"name\": null,\n \"owner\": null,\n \"stage\": null,\n \"type\": null\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"items": [
{
"id": "<string>",
"status": "updated",
"error": {
"code": "<string>",
"message": "<string>",
"details": [
{}
]
}
}
]
}Authorizations
An API key, sent as Authorization: Bearer stfy_live_…. See Authentication for how to get one and which scopes it needs.
Body
application/json
Was this page helpful?