Skip to main content
POST
Put people in a hand-picked view

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

idempotency-key
string

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 - 255
Example:

"3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"

Path Parameters

id
string
required

The hand-picked view, by name or id from list_views. Make one with save_view.

Required string length: 1 - 200

Body

application/json
person_ids
string[]

The id of people already in Ziplined, from search_people or get_person.

Required array length: 1 - 500 elements
Pattern: ^\S{1,200}$
linkedin_urls
string[]

LinkedIn profile links (linkedin.com/in/...), in any form: with or without https or www, with a query string, in any case. Ziplined skips company pages and Sales Navigator links. Together with person_ids at most 500.

Required array length: 1 - 500 elements
Maximum string length: 2000
confirm_id
string

The confirm_id of a needs_confirmation answer: commits what that answer summarised.

Response

The result, or without confirm_id first a needs_confirmation answer: nothing happened yet.

added
integer
required

How many went in now. Someone already in it is 0.

unknown
string[]
required

person_ids this workspace does not know. Not an error: the call applied the rest.

looking_up
integer
required

How many linkedin_urls are new to this workspace. Ziplined looks them up and puts each person it finds in the view.

skipped
object[]
required

Links that went nowhere, with the reason.

app_url
string
required
next_step
object