Skip to main content
GET
List email templates

Authorizations

Authorization
string
header
required

Send either an API token or an OAuth access token as Authorization: Bearer <token>. See the Authentication page for details.

Headers

Privy-Account-Id
string

Target a subaccount instead of the main connected account. Pass a subaccount id from get_account's subaccounts list. Only direct subaccounts of the connected account are reachable — omit this for the main account itself.

Query Parameters

page
integer
default:1
Required range: x >= 1
per_page
integer
default:40
Required range: 10 <= x <= 100
goal
enum<string>

Only gallery templates made for this goal. The account's own saved templates carry no goals and stay listed.

Available options:
welcome_contacts,
announce_sale,
product_launch,
re_engage,
last_chance,
back_in_stock
collection
enum<string>

Only gallery templates in this collection. The account's own saved templates carry no collections and stay listed.

Available options:
bfcm,
seasonal,
basic
source
enum<string>

merchant for the account's own saved templates, privy for Privy's gallery.

Available options:
merchant,
privy

Response

A paginated list of templates.

data
object[]
pagination
object