AI Email Marketing

Replies

Replies that arrived in the Unibox, with the AI classification of each one.

GET/v1/repliesList replies GET/v1/replies/{id}Get a reply POST/v1/replies/{id}/readMark a reply as read

List replies

GET/api/v1/replies

Replies, newest first.

Any API key, read-only included.

Parameters

Name	Type	Description
`campaign_id` query	uuid	Only replies to this campaign.
`unread` query	boolean	Only unread replies.
`per_page` query	integer	Up to 100. Default 25.

Errors

401Missing or invalid key
422Invalid input, or not ready; the body has message and an errors object, one entry per field
429More than 120 requests a minute

Request

curl https://app.zicreach.com/api/v1/replies \
  -H "Authorization: Bearer zk_your_key"

Response200

{
    "data": [
        {
            "id": "9d1c6a2f-8a3e-41c7-b2d4-6e5f0a9c1b22",
            "campaign_id": "9d1c6a2e-4b7f-4e0a-9a51-2f8c3b6d7e10",
            "email_account_id": "9d1c6a2e-4b7f-4e0a-9a51-2f8c3b6d7e10",
            "from": "jane@example.com",
            "subject": "Re: Quick question, Jane",
            "snippet": "This looks interesting. Can we talk on Thursday?",
            "reply_type": "interested",
            "is_read": false,
            "received_at": "2026-09-24T10:31:00Z"
        }
    ],
    "meta": {
        "current_page": 1,
        "last_page": 1,
        "total": 1
    }
}

Get a reply

GET/api/v1/replies/{id}

One reply, including its full body.

Any API key, read-only included.

Parameters

Name	Type	Description
`id`required path	uuid	Reply id.

Errors

401Missing or invalid key
404Not found in this workspace
422Invalid input, or not ready; the body has message and an errors object, one entry per field
429More than 120 requests a minute

Request

curl https://app.zicreach.com/api/v1/replies/9d1c6a2e-4b7f-4e0a-9a51-2f8c3b6d7e10 \
  -H "Authorization: Bearer zk_your_key"

Response200

{
    "data": {
        "id": "9d1c6a2f-8a3e-41c7-b2d4-6e5f0a9c1b22",
        "campaign_id": "9d1c6a2e-4b7f-4e0a-9a51-2f8c3b6d7e10",
        "email_account_id": "9d1c6a2e-4b7f-4e0a-9a51-2f8c3b6d7e10",
        "from": "jane@example.com",
        "subject": "Re: Quick question, Jane",
        "snippet": "This looks interesting. Can we talk on Thursday?",
        "reply_type": "interested",
        "is_read": false,
        "received_at": "2026-09-24T10:31:00Z",
        "body": "Hi Sara,\n\nThis looks interesting. Can we talk on Thursday?\n\nJane"
    }
}

Mark a reply as read

POST/api/v1/replies/{id}/read

Marks the reply as read in the Unibox.

Needs a read and write API key.

Parameters

Name	Type	Description
`id`required path	uuid	Reply id.

Errors

401Missing or invalid key
403Read-only key used for a change, or a key made by someone who is no longer an owner or admin
404Not found in this workspace
422Invalid input, or not ready; the body has message and an errors object, one entry per field
429More than 120 requests a minute

Request

curl -X POST https://app.zicreach.com/api/v1/replies/9d1c6a2e-4b7f-4e0a-9a51-2f8c3b6d7e10/read \
  -H "Authorization: Bearer zk_your_key"

Response200

{
    "message": "Marked as read.",
    "data": {
        "id": "9d1c6a2f-8a3e-41c7-b2d4-6e5f0a9c1b22",
        "campaign_id": "9d1c6a2e-4b7f-4e0a-9a51-2f8c3b6d7e10",
        "email_account_id": "9d1c6a2e-4b7f-4e0a-9a51-2f8c3b6d7e10",
        "from": "jane@example.com",
        "subject": "Re: Quick question, Jane",
        "snippet": "This looks interesting. Can we talk on Thursday?",
        "reply_type": "interested",
        "is_read": true,
        "received_at": "2026-09-24T10:31:00Z"
    }
}