Skip to main content
POST
https://api.talktohumans.app
/
v1
/
views
Create contact view
curl --request POST \
  --url https://api.talktohumans.app/v1/views \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_id": "42",
  "type": "contact",
  "name": "Relevant leads",
  "description": "Leads found in my network",
  "filters": {
    "specific_contacts": {
      "contact_ids": [
        "123",
        "456"
      ]
    }
  }
}
'
{
  "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"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Pass your API key as Authorization: Bearer <api_key>.

Body

application/json
​
name
string
required
Required string length: 1 - 120
​
filters
object
required
​
account_id
string

LinkedIn account ID returned by GET /v1/accounts. Required when the workspace has multiple LinkedIn accounts.

Pattern: ^[1-9][0-9]*$
​
type
enum<string>
default:contact

V1 supports contact views only.

Available options:
contact,
member
​
view_kind
enum<string>

Advanced alias for the underlying TalkToHumans saved-view kind. V1 supports member only.

Available options:
member
​
description
string | null

Response

Contact view created.

​
data
object
required