Documentation

List Templates

List all email templates for the domain associated with the API token.

Production keys only see production templates. Test keys see both test-only and production templates.

GET /templates
Example: /templates

Example

curl -X GET https://api.mailcast.io/v1/templates \
     -H "Authorization: Bearer YOUR_API_TOKEN" \
     -H "Content-Type: application/json"
Response 200
{
  "templates": [
    {
      "template_id": "template_01k3tgwp77epstcb5svg3hnesa",
      "name": "welcome",
      "mjml": "<mjml><mj-body><mj-section><mj-column><mj-text>Hello {{name}}</mj-text></mj-column></mj-section></mj-body></mjml>",
      "from": "hello@example.com",
      "to": null,
      "subject": "Welcome {{name}}",
      "test_only": false,
      "created_at": "2025-08-29T12:00:00Z",
      "updated_at": "2025-08-29T12:00:00Z"
    }
  ]
}