Peach
  1. messaging
Peach
  • messaging
    • Send a pre-approved template message
      POST
    • Poll template message status
      GET
    • Launch a broadcast
      POST
    • Poll broadcast status
      GET
    • Poll template messages status
      GET
  • contacts
    • Create a contact on Peach
      POST
  • orders
    • Create an order
      POST
    • Find order by ID
      GET
    • Create a refund for an order
      POST
  • medias
    • List available medias
      GET
    • Add a media
      POST
    • Remove a media
      DELETE
  • webhooks
    • Order status webhooks
    • Flow execution status webhooks
    • Message delivery status webhooks
    • AI flow execution status webhooks
  1. messaging

Poll template messages status

GET
https://app.trypeach.io/api/v1/template_messages
messaging
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
object {0}

Request 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;'

Responses

🟢200Success
application/json
Body
count
integer 
required
The number of items in the result
next
string  | null 
required
The endpoint to query the next page of the result
prev
string  | null 
required
The endpoint to query the previous page of the result
template_messages
array [object {6}] 
read-onlyrequired
>= 0 items<= 1000 items
id
string 
required
status
enum<string> 
required
Allowed values:
sentdeliveredfailedread
liquid_values
object 
read-onlyrequired
An object containing key/value pairs of variables used as part of the template message.
Example:
{"invoice": "₹1,000"}
event
object  | null 
required
The event that created the Template message
broadcast
object  | null 
required
The Broadcast the Template message belongs to
contact
object 
required
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,
            "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
            }
        }
    ]
}
Previous
Poll broadcast status
Next
Create a contact on Peach
Built with