ObertObert
Contacts

Query Contacts Endpoint

Query contacts with structured filters, search, sort, and pagination.

POST
/api/contacts/query

Authorization

AuthorizationBearer <token>

In: header

Header Parameters

x-tenant-id?string|null

Request Body

filters?
Default[]
search?string|null
linkedin_account_id?string|null
sort_by?string
Default"connected_at"
Value in"name" | "headline" | "public_identifier" | "provider_id" | "linkedin_account_id" | "connected_at" | "created_at" | "lead_status" | "has_chat"
sort_dir?string
Default"desc"
Value in"asc" | "desc"
page?integer
Default1
Range1 <= value
page_size?integer
Default50
Range1 <= value <= 1000

Response Body

application/json

application/json

curl -X POST "https://api.obert.io/api/contacts/query" \  -H "Content-Type: application/json" \  -d '{}'
{
  "data": [
    {
      "id": "string",
      "provider_id": "string",
      "name": "string",
      "headline": "string",
      "profile_url": "string",
      "profile_picture_url": "string",
      "public_identifier": "string",
      "linkedin_account_id": "string",
      "lead_id": "string",
      "connected_at": "2019-08-24T14:15:22Z",
      "created_at": "2019-08-24T14:15:22Z",
      "has_chat": false,
      "chat_id": "string",
      "campaigns": []
    }
  ],
  "total": 0,
  "has_more": false,
  "page": 1,
  "page_size": 0
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

GETList Received Invitations Endpoint

Previous Page

POSTTrigger Sync

Sync all LinkedIn 1st-degree connections for the given account. Fetches the full connections list from Unipile, upserts each into the contacts table, and auto-links matching leads by provider_id. Runs in the background (fire-and-forget) — returns 202 immediately.