Change a view
Saves a named list of people or companies in Ziplined: a view, by filter or by hand. Creates a saved view, or changes the name, icon or filter of an existing one (pass view). A filter view updates itself: whoever matches the filter is in it. A hand_picked view is a list you fill with add_to_view, or at once with person_ids. The view appears in the Ziplined sidebar at once. A filter change on a view with an active sync gives its syncs a new baseline. Then the people who enter because of the change do not go out. So that first call returns a summary and a confirm_id. Call again with the same arguments plus confirm_id.
Use when: To keep a search as a named list, or to change one. A new filter replaces the old one, so start a change from get_view.
Do not use for: Putting people in a hand-picked view (use add_to_view instead), or sending them somewhere (use save_sync or send_people instead).
Example: {"name":"Warm leads NL","filter":{"status":["lead"],"country":["NL"]}}
PATCH
/
v1
/
views
/
{id}
Change a view
curl --request PATCH \
--url https://api.ziplined.io/v1/views/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"filter": {
"status": [],
"country": [
"<string>"
],
"warmth": [],
"seniority": [],
"connection_degree": [
"<string>"
],
"industry": [
"<string>"
],
"is_premium": true,
"is_verified": true,
"min_followers": 1,
"min_connections": 1,
"first_engaged_since": "<string>",
"first_engaged_until": "<string>",
"first_reacted_since": "<string>",
"company": [
"<string>"
],
"job_title": [
"<string>"
],
"company_size_min": 1,
"company_size_max": 1,
"post": [
"<string>"
],
"trend": [],
"has_email": true,
"has_phone": true,
"sent": true,
"in_view": [
"<string>"
],
"not_in_view": [
"<string>"
],
"activity": [
"<string>"
]
},
"icon": "<string>",
"person_ids": [
"<string>"
],
"confirm_id": "<string>"
}
'import requests
url = "https://api.ziplined.io/v1/views/{id}"
payload = {
"name": "<string>",
"filter": {
"status": [],
"country": ["<string>"],
"warmth": [],
"seniority": [],
"connection_degree": ["<string>"],
"industry": ["<string>"],
"is_premium": True,
"is_verified": True,
"min_followers": 1,
"min_connections": 1,
"first_engaged_since": "<string>",
"first_engaged_until": "<string>",
"first_reacted_since": "<string>",
"company": ["<string>"],
"job_title": ["<string>"],
"company_size_min": 1,
"company_size_max": 1,
"post": ["<string>"],
"trend": [],
"has_email": True,
"has_phone": True,
"sent": True,
"in_view": ["<string>"],
"not_in_view": ["<string>"],
"activity": ["<string>"]
},
"icon": "<string>",
"person_ids": ["<string>"],
"confirm_id": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
filter: {
status: [],
country: ['<string>'],
warmth: [],
seniority: [],
connection_degree: ['<string>'],
industry: ['<string>'],
is_premium: true,
is_verified: true,
min_followers: 1,
min_connections: 1,
first_engaged_since: '<string>',
first_engaged_until: '<string>',
first_reacted_since: '<string>',
company: ['<string>'],
job_title: ['<string>'],
company_size_min: 1,
company_size_max: 1,
post: ['<string>'],
trend: [],
has_email: true,
has_phone: true,
sent: true,
in_view: ['<string>'],
not_in_view: ['<string>'],
activity: ['<string>']
},
icon: '<string>',
person_ids: ['<string>'],
confirm_id: '<string>'
})
};
fetch('https://api.ziplined.io/v1/views/{id}', 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.ziplined.io/v1/views/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'filter' => [
'status' => [
],
'country' => [
'<string>'
],
'warmth' => [
],
'seniority' => [
],
'connection_degree' => [
'<string>'
],
'industry' => [
'<string>'
],
'is_premium' => true,
'is_verified' => true,
'min_followers' => 1,
'min_connections' => 1,
'first_engaged_since' => '<string>',
'first_engaged_until' => '<string>',
'first_reacted_since' => '<string>',
'company' => [
'<string>'
],
'job_title' => [
'<string>'
],
'company_size_min' => 1,
'company_size_max' => 1,
'post' => [
'<string>'
],
'trend' => [
],
'has_email' => true,
'has_phone' => true,
'sent' => true,
'in_view' => [
'<string>'
],
'not_in_view' => [
'<string>'
],
'activity' => [
'<string>'
]
],
'icon' => '<string>',
'person_ids' => [
'<string>'
],
'confirm_id' => '<string>'
]),
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.ziplined.io/v1/views/{id}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"filter\": {\n \"status\": [],\n \"country\": [\n \"<string>\"\n ],\n \"warmth\": [],\n \"seniority\": [],\n \"connection_degree\": [\n \"<string>\"\n ],\n \"industry\": [\n \"<string>\"\n ],\n \"is_premium\": true,\n \"is_verified\": true,\n \"min_followers\": 1,\n \"min_connections\": 1,\n \"first_engaged_since\": \"<string>\",\n \"first_engaged_until\": \"<string>\",\n \"first_reacted_since\": \"<string>\",\n \"company\": [\n \"<string>\"\n ],\n \"job_title\": [\n \"<string>\"\n ],\n \"company_size_min\": 1,\n \"company_size_max\": 1,\n \"post\": [\n \"<string>\"\n ],\n \"trend\": [],\n \"has_email\": true,\n \"has_phone\": true,\n \"sent\": true,\n \"in_view\": [\n \"<string>\"\n ],\n \"not_in_view\": [\n \"<string>\"\n ],\n \"activity\": [\n \"<string>\"\n ]\n },\n \"icon\": \"<string>\",\n \"person_ids\": [\n \"<string>\"\n ],\n \"confirm_id\": \"<string>\"\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://api.ziplined.io/v1/views/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"filter\": {\n \"status\": [],\n \"country\": [\n \"<string>\"\n ],\n \"warmth\": [],\n \"seniority\": [],\n \"connection_degree\": [\n \"<string>\"\n ],\n \"industry\": [\n \"<string>\"\n ],\n \"is_premium\": true,\n \"is_verified\": true,\n \"min_followers\": 1,\n \"min_connections\": 1,\n \"first_engaged_since\": \"<string>\",\n \"first_engaged_until\": \"<string>\",\n \"first_reacted_since\": \"<string>\",\n \"company\": [\n \"<string>\"\n ],\n \"job_title\": [\n \"<string>\"\n ],\n \"company_size_min\": 1,\n \"company_size_max\": 1,\n \"post\": [\n \"<string>\"\n ],\n \"trend\": [],\n \"has_email\": true,\n \"has_phone\": true,\n \"sent\": true,\n \"in_view\": [\n \"<string>\"\n ],\n \"not_in_view\": [\n \"<string>\"\n ],\n \"activity\": [\n \"<string>\"\n ]\n },\n \"icon\": \"<string>\",\n \"person_ids\": [\n \"<string>\"\n ],\n \"confirm_id\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ziplined.io/v1/views/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"filter\": {\n \"status\": [],\n \"country\": [\n \"<string>\"\n ],\n \"warmth\": [],\n \"seniority\": [],\n \"connection_degree\": [\n \"<string>\"\n ],\n \"industry\": [\n \"<string>\"\n ],\n \"is_premium\": true,\n \"is_verified\": true,\n \"min_followers\": 1,\n \"min_connections\": 1,\n \"first_engaged_since\": \"<string>\",\n \"first_engaged_until\": \"<string>\",\n \"first_reacted_since\": \"<string>\",\n \"company\": [\n \"<string>\"\n ],\n \"job_title\": [\n \"<string>\"\n ],\n \"company_size_min\": 1,\n \"company_size_max\": 1,\n \"post\": [\n \"<string>\"\n ],\n \"trend\": [],\n \"has_email\": true,\n \"has_phone\": true,\n \"sent\": true,\n \"in_view\": [\n \"<string>\"\n ],\n \"not_in_view\": [\n \"<string>\"\n ],\n \"activity\": [\n \"<string>\"\n ]\n },\n \"icon\": \"<string>\",\n \"person_ids\": [\n \"<string>\"\n ],\n \"confirm_id\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"view": {
"id": "<string>",
"name": "<string>",
"resource": "people",
"kind": "filter",
"icon": "<string>",
"member_count": 123,
"system_key": "your_audience_people",
"sync_setup_url": "<string>",
"sync_setup_urls": {
"clay": "<string>",
"sheets": "<string>"
},
"created_at": "<string>",
"last_used_at": "<string>",
"filter": {
"status": [
"lead"
],
"country": [
"<string>"
],
"warmth": [
"hot"
],
"seniority": [
"C-Level"
],
"connection_degree": [
"<string>"
],
"industry": [
"<string>"
],
"is_premium": true,
"is_verified": true,
"min_followers": 1,
"min_connections": 1,
"first_engaged_since": "<string>",
"first_engaged_until": "<string>",
"first_reacted_since": "<string>",
"company": [
"<string>"
],
"job_title": [
"<string>"
],
"company_size_min": 1,
"company_size_max": 1,
"post": [
"<string>"
],
"trend": [
"new"
],
"has_email": true,
"has_phone": true,
"sent": true,
"in_view": [
"<string>"
],
"not_in_view": [
"<string>"
],
"activity": [
"<string>"
]
}
},
"app_url": "<string>",
"effects": [
"<string>"
]
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Any client-chosen key, a uuid for example. Sending the same request twice with the same key has one effect and returns the same response twice; the same key with a different body returns 409.
Required string length:
1 - 255Example:
"3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"
Path Parameters
The view to change, by name or id from list_views. Leave it out to make a new one. A People view and a Companies view can share a name; then add the subject, as in "Your audience (companies)".
Required string length:
1 - 200Body
application/json
The name of the view in the sidebar. A new view needs it.
Required string length:
1 - 200New views only. filter keeps itself up to date: whoever matches is in it. hand_picked is a list you fill. Left out: filter when you give a filter, else hand_picked.
Available options:
filter, hand_picked The filter in the words of get_filter_options. On a change it replaces the whole filter, so start from get_view.
Show child attributes
Show child attributes
An icon key such as star or flame; null clears it.
Pattern:
^[a-z0-9-]{1,40}$New hand-picked views only: people to put in it right away.
Required array length:
1 - 500 elementsPattern:
^\S{1,200}$The confirm_id of a needs_confirmation answer: commits what that answer summarised.
⌘I
Change a view
curl --request PATCH \
--url https://api.ziplined.io/v1/views/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"filter": {
"status": [],
"country": [
"<string>"
],
"warmth": [],
"seniority": [],
"connection_degree": [
"<string>"
],
"industry": [
"<string>"
],
"is_premium": true,
"is_verified": true,
"min_followers": 1,
"min_connections": 1,
"first_engaged_since": "<string>",
"first_engaged_until": "<string>",
"first_reacted_since": "<string>",
"company": [
"<string>"
],
"job_title": [
"<string>"
],
"company_size_min": 1,
"company_size_max": 1,
"post": [
"<string>"
],
"trend": [],
"has_email": true,
"has_phone": true,
"sent": true,
"in_view": [
"<string>"
],
"not_in_view": [
"<string>"
],
"activity": [
"<string>"
]
},
"icon": "<string>",
"person_ids": [
"<string>"
],
"confirm_id": "<string>"
}
'import requests
url = "https://api.ziplined.io/v1/views/{id}"
payload = {
"name": "<string>",
"filter": {
"status": [],
"country": ["<string>"],
"warmth": [],
"seniority": [],
"connection_degree": ["<string>"],
"industry": ["<string>"],
"is_premium": True,
"is_verified": True,
"min_followers": 1,
"min_connections": 1,
"first_engaged_since": "<string>",
"first_engaged_until": "<string>",
"first_reacted_since": "<string>",
"company": ["<string>"],
"job_title": ["<string>"],
"company_size_min": 1,
"company_size_max": 1,
"post": ["<string>"],
"trend": [],
"has_email": True,
"has_phone": True,
"sent": True,
"in_view": ["<string>"],
"not_in_view": ["<string>"],
"activity": ["<string>"]
},
"icon": "<string>",
"person_ids": ["<string>"],
"confirm_id": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
filter: {
status: [],
country: ['<string>'],
warmth: [],
seniority: [],
connection_degree: ['<string>'],
industry: ['<string>'],
is_premium: true,
is_verified: true,
min_followers: 1,
min_connections: 1,
first_engaged_since: '<string>',
first_engaged_until: '<string>',
first_reacted_since: '<string>',
company: ['<string>'],
job_title: ['<string>'],
company_size_min: 1,
company_size_max: 1,
post: ['<string>'],
trend: [],
has_email: true,
has_phone: true,
sent: true,
in_view: ['<string>'],
not_in_view: ['<string>'],
activity: ['<string>']
},
icon: '<string>',
person_ids: ['<string>'],
confirm_id: '<string>'
})
};
fetch('https://api.ziplined.io/v1/views/{id}', 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.ziplined.io/v1/views/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'filter' => [
'status' => [
],
'country' => [
'<string>'
],
'warmth' => [
],
'seniority' => [
],
'connection_degree' => [
'<string>'
],
'industry' => [
'<string>'
],
'is_premium' => true,
'is_verified' => true,
'min_followers' => 1,
'min_connections' => 1,
'first_engaged_since' => '<string>',
'first_engaged_until' => '<string>',
'first_reacted_since' => '<string>',
'company' => [
'<string>'
],
'job_title' => [
'<string>'
],
'company_size_min' => 1,
'company_size_max' => 1,
'post' => [
'<string>'
],
'trend' => [
],
'has_email' => true,
'has_phone' => true,
'sent' => true,
'in_view' => [
'<string>'
],
'not_in_view' => [
'<string>'
],
'activity' => [
'<string>'
]
],
'icon' => '<string>',
'person_ids' => [
'<string>'
],
'confirm_id' => '<string>'
]),
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.ziplined.io/v1/views/{id}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"filter\": {\n \"status\": [],\n \"country\": [\n \"<string>\"\n ],\n \"warmth\": [],\n \"seniority\": [],\n \"connection_degree\": [\n \"<string>\"\n ],\n \"industry\": [\n \"<string>\"\n ],\n \"is_premium\": true,\n \"is_verified\": true,\n \"min_followers\": 1,\n \"min_connections\": 1,\n \"first_engaged_since\": \"<string>\",\n \"first_engaged_until\": \"<string>\",\n \"first_reacted_since\": \"<string>\",\n \"company\": [\n \"<string>\"\n ],\n \"job_title\": [\n \"<string>\"\n ],\n \"company_size_min\": 1,\n \"company_size_max\": 1,\n \"post\": [\n \"<string>\"\n ],\n \"trend\": [],\n \"has_email\": true,\n \"has_phone\": true,\n \"sent\": true,\n \"in_view\": [\n \"<string>\"\n ],\n \"not_in_view\": [\n \"<string>\"\n ],\n \"activity\": [\n \"<string>\"\n ]\n },\n \"icon\": \"<string>\",\n \"person_ids\": [\n \"<string>\"\n ],\n \"confirm_id\": \"<string>\"\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://api.ziplined.io/v1/views/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"filter\": {\n \"status\": [],\n \"country\": [\n \"<string>\"\n ],\n \"warmth\": [],\n \"seniority\": [],\n \"connection_degree\": [\n \"<string>\"\n ],\n \"industry\": [\n \"<string>\"\n ],\n \"is_premium\": true,\n \"is_verified\": true,\n \"min_followers\": 1,\n \"min_connections\": 1,\n \"first_engaged_since\": \"<string>\",\n \"first_engaged_until\": \"<string>\",\n \"first_reacted_since\": \"<string>\",\n \"company\": [\n \"<string>\"\n ],\n \"job_title\": [\n \"<string>\"\n ],\n \"company_size_min\": 1,\n \"company_size_max\": 1,\n \"post\": [\n \"<string>\"\n ],\n \"trend\": [],\n \"has_email\": true,\n \"has_phone\": true,\n \"sent\": true,\n \"in_view\": [\n \"<string>\"\n ],\n \"not_in_view\": [\n \"<string>\"\n ],\n \"activity\": [\n \"<string>\"\n ]\n },\n \"icon\": \"<string>\",\n \"person_ids\": [\n \"<string>\"\n ],\n \"confirm_id\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ziplined.io/v1/views/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"filter\": {\n \"status\": [],\n \"country\": [\n \"<string>\"\n ],\n \"warmth\": [],\n \"seniority\": [],\n \"connection_degree\": [\n \"<string>\"\n ],\n \"industry\": [\n \"<string>\"\n ],\n \"is_premium\": true,\n \"is_verified\": true,\n \"min_followers\": 1,\n \"min_connections\": 1,\n \"first_engaged_since\": \"<string>\",\n \"first_engaged_until\": \"<string>\",\n \"first_reacted_since\": \"<string>\",\n \"company\": [\n \"<string>\"\n ],\n \"job_title\": [\n \"<string>\"\n ],\n \"company_size_min\": 1,\n \"company_size_max\": 1,\n \"post\": [\n \"<string>\"\n ],\n \"trend\": [],\n \"has_email\": true,\n \"has_phone\": true,\n \"sent\": true,\n \"in_view\": [\n \"<string>\"\n ],\n \"not_in_view\": [\n \"<string>\"\n ],\n \"activity\": [\n \"<string>\"\n ]\n },\n \"icon\": \"<string>\",\n \"person_ids\": [\n \"<string>\"\n ],\n \"confirm_id\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"view": {
"id": "<string>",
"name": "<string>",
"resource": "people",
"kind": "filter",
"icon": "<string>",
"member_count": 123,
"system_key": "your_audience_people",
"sync_setup_url": "<string>",
"sync_setup_urls": {
"clay": "<string>",
"sheets": "<string>"
},
"created_at": "<string>",
"last_used_at": "<string>",
"filter": {
"status": [
"lead"
],
"country": [
"<string>"
],
"warmth": [
"hot"
],
"seniority": [
"C-Level"
],
"connection_degree": [
"<string>"
],
"industry": [
"<string>"
],
"is_premium": true,
"is_verified": true,
"min_followers": 1,
"min_connections": 1,
"first_engaged_since": "<string>",
"first_engaged_until": "<string>",
"first_reacted_since": "<string>",
"company": [
"<string>"
],
"job_title": [
"<string>"
],
"company_size_min": 1,
"company_size_max": 1,
"post": [
"<string>"
],
"trend": [
"new"
],
"has_email": true,
"has_phone": true,
"sent": true,
"in_view": [
"<string>"
],
"not_in_view": [
"<string>"
],
"activity": [
"<string>"
]
}
},
"app_url": "<string>",
"effects": [
"<string>"
]
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}