> ## Documentation Index > Fetch the complete documentation index at: https://docs.ziplined.io/llms.txt > Use this file to discover all available pages before exploring further. # Put people in a hand-picked view > Puts people in a hand-picked view (a list somebody keeps by hand). Give person ids, LinkedIn profile links, or both. Someone already in it is not an error. A person id this workspace does not know comes back in unknown, and the rest still goes in. A link of somebody already in the workspace goes in at once, free. For a link of somebody new, Ziplined looks the person up on LinkedIn. Each person it finds costs 1 credit and appears in the view in about 10 minutes. A link that finds nobody costs nothing. So when there are new people, a workspace on credits first gets a summary and a confirm_id. Ziplined adds them when you call again with the same arguments plus confirm_id. Links that are no profile, and people marked not a lead, come back in skipped. A filter view refuses, because its filter decides who is in it. Use when: After a conversation: "park these five for next quarter", "collect everyone who reacted to the launch". Or the user has a list from outside Ziplined as LinkedIn links. For example an event guest list, webinar sign-ups or an export from another tool. Make the view first with save_view if it does not exist. Do not use for: A filter view (use save_view instead, to change its filter). Sending people somewhere (use send_people instead). Finding people by name (use search_people instead). Example: {"view":"Webinar sign-ups","linkedin_urls":["https://www.linkedin.com/in/example-person"]} ## OpenAPI ````yaml /openapi.json post /v1/views/{id}/people openapi: 3.1.0 info: title: Ziplined API version: 1.0.0 description: >- LinkedIn engagement data about people, companies and posts. The workspace comes from the credential; lists page with `limit` and `cursor`. servers: - url: https://api.ziplined.io description: Production security: [] tags: - name: People description: The people in your workspace, and what you sent them. - name: Companies description: The companies those people work at. - name: Posts description: Your own posts and their numbers. - name: Engagements description: One act by one person on one post. - name: Insights description: Period against period, and the series behind it. - name: Views description: The saved views of the app, and who is in a hand-picked one. - name: Audiences description: The scored target groups, and their membership. - name: ICP description: 'Who you sell to: the rules every person is scored against.' - name: Sources description: What your radar collects from. - name: Account description: Who is asking, what is set up, and what is next. - name: Credits description: What is left to spend on sources, and when it resets. - name: Integrations description: 'Where syncs send people: webhook, email, Slack and app destinations.' paths: /v1/views/{id}/people: post: tags: - Views summary: Put people in a hand-picked view description: >- Puts people in a hand-picked view (a list somebody keeps by hand). Give person ids, LinkedIn profile links, or both. Someone already in it is not an error. A person id this workspace does not know comes back in unknown, and the rest still goes in. A link of somebody already in the workspace goes in at once, free. For a link of somebody new, Ziplined looks the person up on LinkedIn. Each person it finds costs 1 credit and appears in the view in about 10 minutes. A link that finds nobody costs nothing. So when there are new people, a workspace on credits first gets a summary and a confirm_id. Ziplined adds them when you call again with the same arguments plus confirm_id. Links that are no profile, and people marked not a lead, come back in skipped. A filter view refuses, because its filter decides who is in it. Use when: After a conversation: "park these five for next quarter", "collect everyone who reacted to the launch". Or the user has a list from outside Ziplined as LinkedIn links. For example an event guest list, webinar sign-ups or an export from another tool. Make the view first with save_view if it does not exist. Do not use for: A filter view (use save_view instead, to change its filter). Sending people somewhere (use send_people instead). Finding people by name (use search_people instead). Example: {"view":"Webinar sign-ups","linkedin_urls":["https://www.linkedin.com/in/example-person"]} parameters: - schema: type: string minLength: 1 maxLength: 200 description: >- The hand-picked view, by name or id from list_views. Make one with save_view. required: true description: >- The hand-picked view, by name or id from list_views. Make one with save_view. name: id in: path - schema: type: string minLength: 1 maxLength: 255 description: >- 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. example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d required: false description: >- 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. name: idempotency-key in: header requestBody: content: application/json: schema: type: object properties: person_ids: type: array items: type: string pattern: ^\S{1,200}$ minItems: 1 maxItems: 500 description: >- The `id` of people already in Ziplined, from search_people or get_person. linkedin_urls: type: array items: type: string maxLength: 2000 minItems: 1 maxItems: 500 description: >- 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. confirm_id: type: string description: >- The confirm_id of a needs_confirmation answer: commits what that answer summarised. responses: '200': description: >- The result, or without confirm_id first a needs_confirmation answer: nothing happened yet. content: application/json: schema: anyOf: - type: object properties: added: type: integer description: How many went in now. Someone already in it is 0. unknown: type: array items: type: string description: >- person_ids this workspace does not know. Not an error: the call applied the rest. looking_up: type: integer description: >- How many linkedin_urls are new to this workspace. Ziplined looks them up and puts each person it finds in the view. skipped: type: array items: type: object properties: url: type: string description: The link as the call gave it. reason: type: string enum: - company_page - sales_navigator - not_a_profile - removed description: >- company_page, sales_navigator or not_a_profile: not a profile link. removed: marked not a lead in this workspace. required: - url - reason description: Links that went nowhere, with the reason. next_step: type: object properties: kind: type: string enum: - tool tool: type: string reason: type: string required: - kind - tool - reason app_url: type: string required: - added - unknown - looking_up - skipped - app_url - $ref: '#/components/schemas/Confirmation' '400': description: A filter value is invalid, or this resource has no such filter. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Missing or invalid bearer token. content: application/json: schema: $ref: '#/components/schemas/Error' '402': description: Not included in this plan, or a usage cap was exceeded. content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Wrong workspace, or the credential lacks the required scope. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: No such record, or it does not belong to this workspace. content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: >- The same `Idempotency-Key` was used for a different request, or that request is still in flight. content: application/json: schema: $ref: '#/components/schemas/Error' security: - bearerAuth: [] components: schemas: Confirmation: type: object properties: needs_confirmation: type: boolean enum: - true message: type: string description: >- Nothing changed yet. Ask the user, then send the same request with confirm_id. confirm_id: type: string description: Send it back with the same request to commit. Valid for 10 minutes. summary: nullable: true description: What the commit will do, to show the user before confirming. cost: type: object properties: estimate: type: number ceiling: type: number required: - estimate - ceiling description: >- Credits: estimate is what the commit is expected to spend. ceiling is 0: no ceiling is stored, and later spend stops when the balance reaches 0. expires_at: type: string description: ISO instant. After it, confirm_id is refused as confirm_stale. required: - needs_confirmation - message - confirm_id - cost - expires_at Error: type: object properties: error: type: object properties: code: type: string message: type: string required: - code - message required: - error securitySchemes: bearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.