PostZen
Contacts

Get contact channels

GET
/v1/contacts/{contactId}/channels

Requires read_only. Returns all channels oldest first by createdAt, including lastActiveAt. Unknown or out-of-scope contacts return 404 contactNotFound.

Authorization

bearerAuth
AuthorizationBearer <token>

PostZen API key.

In: header

Path Parameters

contactId*string

Contact owning this channel.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/contacts/jd7contact123/channels"
{  "channels": [    {      "id": "jd7channel123",      "contactId": "jd7contact123",      "accountId": "jd7account123",      "platform": "instagram",      "platformIdentifier": "178414000001",      "displayIdentifier": "@jane",      "isSubscribed": true,      "conversationId": "t_12345",      "metadata": {        "locale": "en"      },      "lastActiveAt": "2026-09-19T12:00:00.000Z",      "createdAt": "2026-09-19T12:00:00.000Z"    }  ]}
{  "error": "JSON body is required"}
{  "error": "Unauthorized"}
{  "error": "API key requires read_write permission"}
{  "error": "Not found"}
{  "error": "rate_limited",  "retryAfter": 30}
{  "error": "Failed to create post"}

Delete a contact DELETE

Requires read_write. Limited to 300 deletes/hour/user. Atomically deletes the contact and all its channels (maximum 20). Unknown or out-of-scope ids return 404 contactNotFound.

List webhooks GET

Returns webhook endpoints visible to the API key, newest first. Secret and custom header values are never returned.