Find subscriber

Subscriber profile from Search, found by phone number, name or email.

GET https://cotlet.dev/api/v1/postscript/subscribers/find

read

Searches Postscript for one subscriber and returns the profile fields Postscript shows under Subscriber Details: status, subscriber ID, how and when they subscribed, tags, the last message sent, messages sent and link clicks. Use it before a reply or a segment to see who the person is.

Parameters

Parameters: find_subscriber
NameTypeDescription
query string required string Phone number, name or email.

Request

cURL
curl "https://cotlet.dev/api/v1/postscript/subscribers/find?query=query" \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("postscript", "find_subscriber", {"query":"query"})
Node.js
const result = await cotlet.call('postscript', 'find_subscriber', {"query":"query"});
CLI
cotlet call postscript find_subscriber --data '{"query":"query"}'

Example response

JSON

{
  "subscribers": [
    {
      "subscriber_id": "7740215",
      "name": "Dana R.",
      "phone": "+1 555 0142",
      "status": "active",
      "subscribed_via": "keyword JOIN",
      "subscribed_at": "2026-06-02",
      "tags": [
        "vip"
      ],
      "last_message_at": "2026-10-21",
      "messages_sent": 14,
      "link_clicks": 3
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.