Skip to main content
POST
/
custom-templates
/
osm
/
search
Search OSM Templates
curl --request POST \
  --url https://api-{dc}.moengage.com/v1.0/custom-templates/osm/search \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "page": 1,
  "entries": 10,
  "template_source": [
    "API"
  ],
  "sort_params": [
    {
      "last_modified_date": "DESCENDING"
    }
  ]
}
'
{
  "data": [
    {
      "meta_info": {
        "template_id": "1234567890123",
        "template_name": "NAME_OF_THE_TEMPLATE",
        "template_version": "1",
        "created_by": "[email protected]",
        "channel": "ON-SITE",
        "template_source": "API",
        "template_type": "CUSTOM"
      },
      "external_template_id": "4a1afbc5-4c31-4f19-8c23-793e27af01aa",
      "version": 1,
      "basic_details": {
        "payload": "<html>...</html>",
        "preview_image": "https://pbs.twimg.com/profile_images/10ydbKG1.jpg"
      },
      "created_by": "[email protected]",
      "created_at": "2023-08-01T07:58:53.880000",
      "updated_by": "[email protected]",
      "updated_at": "2023-08-01T07:58:53.880000"
    }
  ]
}
Mandatory Pagination We are introducing mandatory pagination, effective November 15, 2025. All calls to this API must include the following two parameters:
  • page: The page number of the results you wish to fetch.
  • entries: The number of templates to return per page, with a maximum value of 15.
Please update all integrations to include these parameters. API requests submitted without them after the effective date will result in an error and fail to execute.

​
Rate Limit

The rate limit is 100 RPM.

Authorizations

​
Authorization
string
header
required

Authentication is done via Basic Auth. This requires a base64-encoded string of your credentials in the format 'username:password'.

  • Username: Use your MoEngage workspace ID (also known as the App ID). You can find it in the MoEngage dashboard at Settings > Account > APIs > Workspace ID (earlier app id).
  • Password: Use your API Key, which you can find within the Campaign report/Business events/Custom templates/Catalog API/Inform Report tile.

For more information on authentication and getting your credentials, refer here.

Body

application/json

Search filters for finding OSM templates.

Notes:

  • page and entries are mandatory effective November 15, 2025. All other fields are optional.
  • An empty request body will fetch all templates.
​
page
integer
required

The index of the page to be returned. Mandatory after Nov 15, 2025.

​
entries
integer
required

The number of entries/templates to return per page. Max 15. Mandatory after Nov 15, 2025.

Required range: x <= 15
​
template_name
string

The name of the template to search for. Returns templates matching this name.

​
template_id
string

The unique ID of the template provided by you.

​
template_source
enum<string>[]

Filter templates by their source.

Available options:
API,
MOENGAGE
​
template_type
enum<string>[]

Filter templates by type (Custom or Pre-built).

Available options:
CUSTOM,
PRE_BUILT
​
created_by
string<email>[]

Filter templates by the creator's email identifier.

​
updated_by
string<email>[]

Filter templates by the updater's email identifier.

​
sort_params
object[]

Sort the templates by multiple fields in ASCENDING or DESCENDING order. Priority follows the array order.

​
external_template_ids
object[]

Search for multiple templates using pairs of external_template_id and version.

Response

Search successful. Returns a list of templates.

​
data
object[]

A list containing the details of the templates found.