> ## Documentation Index > Fetch the complete documentation index at: https://talktohumans.app/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create contact view > Create a TalkToHumans contact view/list from specific contacts. ## OpenAPI ````yaml /openapi.yaml post /v1/views openapi: 3.0.3 info: title: TalkToHumans Public API version: 1.0.0 license: name: Proprietary description: > Read and organize the LinkedIn workspace data your team already manages in TalkToHumans: accounts, people, tags, notes, sequence state, conversations, and views. servers: - url: https://api.talktohumans.app description: TalkToHumans API security: - bearerAuth: [] tags: - name: Organization description: Workspace details for the current API key. - name: LinkedIn description: >- Accounts, contacts, companies, and conversations already synced into TalkToHumans. - name: Enrich description: Profile enrichment for LinkedIn people and companies. - name: Views description: Saved TalkToHumans views and lists. paths: /v1/views: post: tags: - Views summary: Create contact view description: | Create a TalkToHumans contact view/list from specific contacts. operationId: createView requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateViewRequest' example: account_id: '42' type: contact name: Relevant leads description: Leads found in my network filters: specific_contacts: contact_ids: - '123' - '456' responses: '201': description: Contact view created. content: application/json: schema: $ref: '#/components/schemas/CreateViewEnvelope' example: data: view: id: '789' public_id: mem_2f5e3a4b type: contact view_kind: member name: Relevant leads description: Leads found in my network account: account_id: '42' display_name: Jane Doe provider_account_id: ACoAA000000 owner_user_id: '7' selected_contact_ids: - '123' - '456' simple_filters_json: >- {"combinator":"and","not":false,"rules":[{"field":"specific_contacts","operator":"contains","value":["linkedin:participant:urn:li:fsd_profile:abc"],"id":"8f20a6c8-9f18-4db6-931f-a018f815c604","valueSource":"value"}]} app_url: https://app.talktohumans.app/contacts/mem_2f5e3a4b created_at: '2026-05-12T12:00:00Z' updated_at: '2026-05-12T12:00:00Z' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalServerError' components: schemas: CreateViewRequest: type: object additionalProperties: false required: - name - filters properties: account_id: type: string description: >- LinkedIn account ID returned by `GET /v1/accounts`. Required when the workspace has multiple LinkedIn accounts. pattern: ^[1-9][0-9]*$ type: type: string description: V1 supports contact views only. enum: - contact - member default: contact view_kind: type: string description: >- Advanced alias for the underlying TalkToHumans saved-view kind. V1 supports `member` only. enum: - member name: type: string minLength: 1 maxLength: 120 description: type: string nullable: true filters: $ref: '#/components/schemas/CreateViewFilters' CreateViewEnvelope: type: object additionalProperties: false required: - data properties: data: $ref: '#/components/schemas/CreateViewResponse' CreateViewFilters: type: object additionalProperties: false required: - specific_contacts properties: specific_contacts: $ref: '#/components/schemas/SpecificContactsFilter' CreateViewResponse: type: object additionalProperties: false required: - view properties: view: $ref: '#/components/schemas/CreatedView' Error: type: object additionalProperties: false required: - code - message properties: code: type: string description: Machine-readable error code. enum: - unauthorized - forbidden - not_found - bad_request - internal_error - conflict - rate_limit_exceeded - billing_payment_failed - billing_subscription_incomplete - billing_subscription_expired - billing_grace_period - billing_feature_not_available - billing_insufficient_credits - billing_invalid - upstream_error message: type: string description: Human-readable error message. debug: type: string description: Development-only debug details. SpecificContactsFilter: type: object additionalProperties: false required: - contact_ids properties: contact_ids: type: array minItems: 1 maxItems: 500 description: Contact IDs returned by `GET /v1/contacts`. items: type: string pattern: ^[1-9][0-9]*$ CreatedView: type: object additionalProperties: false required: - id - public_id - type - view_kind - name - account - selected_contact_ids - simple_filters_json - app_url - created_at - updated_at properties: id: type: string description: >- TalkToHumans view ID. Pass as `view_id` on `GET /v1/contacts` to page through its contacts. public_id: type: string description: >- Public saved-view ID used in app URLs. Also accepted as `view_id` on `GET /v1/contacts`. type: type: string enum: - contact view_kind: type: string enum: - member name: type: string description: type: string nullable: true account: $ref: '#/components/schemas/AccountSummary' selected_contact_ids: type: array items: type: string simple_filters_json: type: string description: Serialized TalkToHumans saved-view simple filter group. advanced_filters_json: type: string nullable: true description: >- Serialized TalkToHumans saved-view advanced filter group. V1 returns null. app_url: type: string format: uri created_at: type: string format: date-time updated_at: type: string format: date-time AccountSummary: type: object additionalProperties: false required: - account_id - display_name - provider_account_id - owner_user_id properties: account_id: type: string description: TalkToHumans account ID. display_name: type: string provider_account_id: type: string description: LinkedIn provider account ID. owner_user_id: type: string description: TalkToHumans user ID that owns the account. responses: BadRequest: description: Invalid request parameters. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: bad_request message: Invalid request parameters Unauthorized: description: Missing, malformed, or invalid API key. content: application/json: schema: $ref: '#/components/schemas/Error' examples: missingAuthorization: value: code: unauthorized message: Authorization header is required invalidAuthorizationFormat: value: code: unauthorized message: Authorization header must use Bearer scheme invalidAPIKey: value: code: unauthorized message: Invalid API key Forbidden: description: >- API access is not enabled for the workspace, or the credential cannot access the requested workspace. content: application/json: schema: $ref: '#/components/schemas/Error' examples: forbidden: value: code: forbidden message: you don't have access to this organization featureUnavailable: value: code: billing_feature_not_available message: >- Feature 'TalkToHumansAPI' is not available in your current plan insufficientCredits: value: code: billing_insufficient_credits message: Insufficient credits RateLimited: description: >- Rate limit exceeded. Public routes allow 50 requests per 10 seconds per IP and endpoint. headers: Retry-After: description: Seconds to wait before retrying the request. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' example: code: rate_limit_exceeded message: Rate limit exceeded InternalServerError: description: Unexpected server error. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: internal_error message: An internal error occurred securitySchemes: bearerAuth: type: http scheme: bearer description: 'Pass your API key as `Authorization: Bearer `.' ````