1. template-messages
Peach
  • template-messages
    • Send a pre-approved template message
      POST
    • Poll template message status
      GET
    • Poll template messages status
      GET
    • Connect to AI Agent
      POST
    • Send an App message
      POST
  • broadcasts
    • List broadcasts
      GET
    • Launch a broadcast
      POST
    • Poll broadcast status
      GET
    • Get broadcast details
      GET
    • Archive broadcast
      PATCH
    • Cancel broadcast
      PATCH
  • whatsapp_templates
    • List all templates
      GET
    • Create a template
      POST
    • Update template
      PATCH
    • Archive template
      PATCH
    • Pause template
      PATCH
    • Submit template
      PATCH
    • Fetch template details
      GET
  • conversations
    • List messages
      GET
    • List conversations
      GET
    • Update conversation status
      PATCH
    • Agent Assignment
      POST
    • Close Conversation
      POST
  • contacts
    • Create multiple contacts
      POST
    • Update a contact
      PATCH
    • Create a contact
      POST
    • Bulk update communication preferences
      POST
  • orders
    • Create an order
    • Find order by ID
    • Create a refund for an order
  • medias
    • About uploaded media
    • List available medias
    • Add a media (Deprecated)
    • Remove a media
    • Create a direct upload for media
    • Finalize a direct uploaded media
  • webhooks
    • Order status webhooks
    • Flow execution status webhooks
    • Message delivery status webhooks
    • AI Agent Execution Webhooks
  • Schemas
    • Schemas
      • WhatsApp Template
      • WhatsApp Template Parameters
      • Order
      • RefundRequest
      • Contact
      • LineItem
      • OrderExpiry
      • TemplateMessage
      • AnyValue
      • Argument
      • Message
      • MessageResponse
  1. template-messages

Poll template messages status

GET
https://app.trypeach.io/api/v1/template_messages
Poll the delivery status of the template messages sent from the account, ordered by the last time they were updated.
Template messages can be filtered by the Broadcast that they belong to, as well as the time since they were last updated, which defaults to 24 hours ago.

Request

Authorization
Add parameter in header
Authorization
Example:
Authorization: ********************
Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://app.trypeach.io/api/v1/template_messages?page=1&per=1000&broadcast_id=cmp_1234abcd&updated_since=2025-05-27T05:37:47Z' \
--header 'Authorization: <api-key>'

Responses

🟢200Success
application/json
Body

Example
{
    "count": 3,
    "next": "https://app.trypeach.io/api/v1/template_messages?page=2&per=3",
    "prev": null,
    "template_messages": [
        {
            "id": "cmsg_1234abcd",
            "status": "sent",
            "liquid_values": {
                "cta_1": "Foo",
                "account_name": "John Doe"
            },
            "event": {
                "id": "evt_1234abcd",
                "status": "processed",
                "event_url": "https://app.trypeach.io/api/v1/events/evt_1234abcd"
            },
            "broadcast": null,
            "message_events": [
                {
                    "event_type": "sent",
                    "created_at": "2025-05-28T10:11:29.744Z"
                },
                {
                    "event_type": "delivered",
                    "created_at": "2025-05-28T10:11:31.466Z"
                },
                {
                    "event_type": "read",
                    "created_at": "2025-05-28T10:12:16.529Z"
                }
            ],
            "contact": {
                "id": 1,
                "account_id": 1,
                "name": "John Doe",
                "phone_number": "+919988776655",
                "first_name": "John",
                "last_name": "Doe",
                "country_code": "91",
                "language": "en"
            }
        },
        {
            "id": "cmsg_2345bcde",
            "status": "sent",
            "liquid_values": {
                "cta_1": null,
                "account_name": "Jane Doe"
            },
            "event": null,
            "broadcast": {
                "id": "cmp_12345abcd",
                "name": "Instant Broadcast via API",
                "broadcast_url": "https://app.trypeach.io/api/v1/events/evt_8wn0RK4qrxVvUJLpyNxebJgZ"
            },
            "contact": {
                "id": 2,
                "account_id": 1,
                "name": "Jane Doe",
                "phone_number": "+918877665544",
                "first_name": "Jane",
                "last_name": "Doe",
                "country_code": "91",
                "language": null
            }
        }
    ]
}
Modified at 2026-04-21 12:14:00
Previous
Poll template message status
Next
Connect to AI Agent
Built with