Manage Templates

List Templates

GET /backend/templates

Filters (Query Parameters)

Parameter	Type	Description
`gupshup_app_id`	string	Filter by Gupshup app
`status`	string	Filter by status (`APPROVED`, `PENDING`, `REJECTED`)
`category`	string	Filter by category (`MARKETING`, `UTILITY`, `AUTHENTICATION`)
`language`	string	Filter by language (e.g., `pt_BR`, `en`)

Example

curl -X GET "https://api.leavo.ai/backend/templates?status=APPROVED&language=en" \
  -H "Authorization: Bearer your_api_key_here"

const response = await fetch(
  'https://api.leavo.ai/backend/templates?status=APPROVED&language=en',
  {
    headers: { 'Authorization': 'Bearer your_api_key_here' }
  }
);
const templates = await response.json();

Response (200):

[
  {
    "id": "uuid",
    "tenant_id": "uuid",
    "gupshup_app_id": "app_12345",
    "template_name": "welcome_v1",
    "template_id": "gupshup_id",
    "language": "en",
    "status": "APPROVED",
    "category": "MARKETING",
    "components": [...],
    "last_synced_at": "2024-01-15T10:00:00Z"
  }
]

Get Template

GET /backend/templates/{id}

Returns complete template details including all components.

Delete Template

DELETE /backend/templates/{id}

Deleting a template automatically removes all cadence associations.

Response: 204 No Content

Sync Templates

POST /backend/templates/sync

Endpoint called by meta-service to sync templates from Gupshup. Body:

{
  "app_id": "app_12345",
  "templates": [
    {
      "id": "gupshup_template_id",
      "name": "welcome_v1",
      "language": "en",
      "status": "APPROVED",
      "category": "MARKETING",
      "components": [
        {
          "type": "BODY",
          "text": "Hello {{1}}, welcome to {{2}}!"
        }
      ]
    }
  ]
}

Response (200):

{
  "synced_count": 5,
  "app_id": "app_12345"
}

Existing templates are updated (upsert). New templates are created automatically. The uniqueness key is (tenant_id, gupshup_app_id, template_name, language).

Overview

Leads

Status

Tags

Knowledge Base

Pipeline (CRM)

Webhooks

Custom Fields

Cadences

Conversations

Messages

Departments

File Uploads

Templates (Meta/Gupshup)

Follow-up

List Templates

Filters (Query Parameters)

Example

Get Template

Delete Template

Sync Templates

​List Templates

​Filters (Query Parameters)

​Example

​Get Template

​Delete Template

​Sync Templates

List Templates

Filters (Query Parameters)

Example

Get Template

Delete Template

Sync Templates