Templates
The template object
Attributes
idstring (uuid)requiredIdentifier for this resource.
createdAtintegerrequiredmin0formatint64Unix timestamp in milliseconds when this resource was created.
namestringrequiredlength1–512Human-readable name for this resource.
categorystringrequiredSpecifies category for this management management template.
languagestringrequiredLanguage or locale code used for this content.
statusstringrequiredCurrent status of this resource or operation.
kindstringrequiredKind discriminator for this object.
definitionobjectrequirednullableStructured definition for this resource.
sampleValuesobjectrequirednullableExample values used to preview this template field.
cloudLinksarray of objectrequiredCloud links associated with this management management template.
updatedAtintegerrequiredmin0formatint64Unix timestamp in milliseconds when this resource was last updated.
{
"id": "00000000-0000-4000-8000-000000000000",
"createdAt": 0,
"name": "string",
"category": "string",
"language": "string",
"status": "string",
"kind": "string",
"definition": {},
"sampleValues": {},
"cloudLinks": [
{}
],
"updatedAt": 0
}The Messaging API template object
Attributes
idstringrequiredIdentifier for this resource.
namestringrequiredHuman-readable name for this resource.
categorystringrequiredSpecifies category for this native message template.
languagestringrequiredLanguage or locale code used for this content.
statusstringrequiredCurrent status of this resource or operation.
kindstringrequiredKind discriminator for this object.
definitionanyStructured definition for this resource.
sampleValuesanyExample values used to preview this template field.
cloudLinksarray of anyrequiredCloud links associated with this native message template.
createdAtnumberrequiredUnix timestamp in milliseconds when this resource was created.
updatedAtnumberrequiredUnix timestamp in milliseconds when this resource was last updated.
{
"id": "string",
"name": "string",
"category": "string",
"language": "string",
"status": "string",
"kind": "string",
"definition": null,
"sampleValues": null,
"cloudLinks": [
null
],
"createdAt": 0,
"updatedAt": 0
}Create project template
- Base URL
https://api.polymorfa.com- Required permission
templates:manage
Path parameters
projectSlugstringrequiredSpecifies project slug for this path parameter.
Body
namestringrequiredmin length1pattern^[a-z0-9_]+$Human-readable name for this resource.
definitionobjectrequiredStructured definition for this resource.
sampleValuesobjectExample values used to preview this template field.
Responses
201Created
successbooleanrequiredWhether the request succeeded.
Allowed valuestruedataobjectrequiredStructured data carried by this object.
Show 11 child fields
Show 3 headers
400Bad request — request body or params failed validation
401Missing or invalid authentication token
403Authenticated but not permitted (missing scope or rule violation)
404Resource not found
500Internal server error
curl -X POST "https://api.polymorfa.com/messaging/projects/<projectSlug>/templates" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Polymorfa-Version: 2026-09-22" \
-H "Content-Type: application/json" \
-d '{
"name": "string",
"definition": {}
}'{
"success": true,
"data": {
"id": "string",
"name": "string",
"category": "string",
"language": "string",
"status": "string",
"kind": "string",
"cloudLinks": [
null
],
"createdAt": 0,
"updatedAt": 0
}
}Create message template
- Base URL
https://api.polymorfa.com- Required permission
templates:manage
Creates an incomplete or complete message-template draft in one project.
Requires templates:manage. Project tokens only access resources in their own project.
Body
projectIdstring (uuid)requiredIdentifier of the Polymorfa project that owns this resource.
draftIdstring (uuid)Identifier of the saved draft.
namestringrequiredlength1–512Human-readable name for this resource.
definitionobjectrequiredStructured definition for this resource.
sampleValuesobjectnullableExample values used to preview this template field.
Responses
200Success
datastring (uuid)requiredStructured data carried by this object.
Show 3 headers
400A path, query, or request-body value did not pass validation.
401Missing/invalid credential for this audience.
403Authenticated but lacks the required scope/role/audience.
404The requested resource was not found inside the authenticated team or project scope.
curl -X POST "https://api.polymorfa.com/platform/templates" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Polymorfa-Version: 2026-09-22" \
-H "Content-Type: application/json" \
-d '{
"projectId": "00000000-0000-4000-8000-000000000000",
"name": "string",
"definition": {}
}'{
"data": "00000000-0000-4000-8000-000000000000"
}List project templates
- Base URL
https://api.polymorfa.com- Required permission
templates:read
Path parameters
projectSlugstringrequiredSpecifies project slug for this path parameter.
Responses
200Templates
successbooleanrequiredWhether the request succeeded.
Allowed valuestruedataarray of objectrequiredStructured data carried by this object.
Show 11 child fields
Show 3 headers
400Bad request — request body or params failed validation
401Missing or invalid authentication token
403Authenticated but not permitted (missing scope or rule violation)
404Resource not found
500Internal server error
curl "https://api.polymorfa.com/messaging/projects/<projectSlug>/templates" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Polymorfa-Version: 2026-09-22"{
"success": true,
"data": [
{
"id": "string",
"name": "string",
"category": "string",
"language": "string",
"status": "string",
"kind": "string",
"cloudLinks": [
null
],
"createdAt": 0,
"updatedAt": 0
}
]
}List message templates
- Base URL
https://api.polymorfa.com- Required permission
templates:read
Lists the message-template drafts in one project.
Requires templates:read. Project tokens only access resources in their own project.
Query parameters
projectIdstringrequiredIdentifier of the Polymorfa project that owns this resource.
Responses
200Success
dataarray of objectrequiredmax items500Structured data carried by this object.
Show 11 child fields
Show 3 headers
400A path, query, or request-body value did not pass validation.
401Missing/invalid credential for this audience.
403Authenticated but lacks the required scope/role/audience.
404The requested resource was not found inside the authenticated team or project scope.
curl "https://api.polymorfa.com/platform/templates?projectId=<projectId>" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Polymorfa-Version: 2026-09-22"{
"data": [
{
"id": "00000000-0000-4000-8000-000000000000",
"createdAt": 0,
"name": "string",
"category": "string",
"language": "string",
"status": "string",
"kind": "string",
"definition": {},
"sampleValues": {},
"cloudLinks": [
{}
],
"updatedAt": 0
}
]
}Get project template
- Base URL
https://api.polymorfa.com- Required permission
templates:read
Path parameters
projectSlugstringrequiredSpecifies project slug for this path parameter.
idstringrequiredIdentifier for this resource.
Responses
200Template
successbooleanrequiredWhether the request succeeded.
Allowed valuestruedataobjectrequiredStructured data carried by this object.
Show 11 child fields
Show 3 headers
400Bad request — request body or params failed validation
401Missing or invalid authentication token
403Authenticated but not permitted (missing scope or rule violation)
404Resource not found
500Internal server error
curl "https://api.polymorfa.com/messaging/projects/<projectSlug>/templates/<id>" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Polymorfa-Version: 2026-09-22"{
"success": true,
"data": {
"id": "string",
"name": "string",
"category": "string",
"language": "string",
"status": "string",
"kind": "string",
"cloudLinks": [
null
],
"createdAt": 0,
"updatedAt": 0
}
}Get message template
- Base URL
https://api.polymorfa.com- Required permission
templates:read
Gets one message-template draft from the specified project.
Requires templates:read. Project tokens only access resources in their own project.
Path parameters
templateIdstringrequiredIdentifier of the message template.
Query parameters
projectIdstringrequiredIdentifier of the Polymorfa project that owns this resource.
Responses
200Success
dataobjectrequirednullableStructured data carried by this object.
Show 11 child fields
Show 3 headers
400A path, query, or request-body value did not pass validation.
401Missing/invalid credential for this audience.
403Authenticated but lacks the required scope/role/audience.
404The requested resource was not found inside the authenticated team or project scope.
curl "https://api.polymorfa.com/platform/templates/<templateId>?projectId=<projectId>" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Polymorfa-Version: 2026-09-22"{
"data": {
"id": "00000000-0000-4000-8000-000000000000",
"createdAt": 0,
"name": "string",
"category": "string",
"language": "string",
"status": "string",
"kind": "string",
"definition": {},
"sampleValues": {},
"cloudLinks": [
{}
],
"updatedAt": 0
}
}Update project template
- Base URL
https://api.polymorfa.com- Required permission
templates:manage
Path parameters
projectSlugstringrequiredSpecifies project slug for this path parameter.
idstringrequiredIdentifier for this resource.
Body
namestringmin length1Human-readable name for this resource.
statusstringStatus value to assign to this resource.
definitionobjectStructured definition for this resource.
sampleValuesobjectExample values used to preview this template field.
Responses
200Updated
successbooleanrequiredWhether the request succeeded.
Allowed valuestruedataobjectrequiredStructured data carried by this object.
Show 11 child fields
Show 3 headers
400Bad request — request body or params failed validation
401Missing or invalid authentication token
403Authenticated but not permitted (missing scope or rule violation)
404Resource not found
500Internal server error
curl -X PATCH "https://api.polymorfa.com/messaging/projects/<projectSlug>/templates/<id>" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Polymorfa-Version: 2026-09-22" \
-H "Content-Type: application/json" \
-d '{
"name": "string",
"status": "string",
"definition": {},
"sampleValues": {}
}'{
"success": true,
"data": {
"id": "string",
"name": "string",
"category": "string",
"language": "string",
"status": "string",
"kind": "string",
"cloudLinks": [
null
],
"createdAt": 0,
"updatedAt": 0
}
}Update message template
- Base URL
https://api.polymorfa.com- Required permission
templates:manage
Updates one message-template draft in the project supplied in the request body.
Requires templates:manage. Project tokens only access resources in their own project.
Path parameters
templateIdstringrequiredIdentifier of the message template.
Body
projectIdstring (uuid)requiredIdentifier of the Polymorfa project that owns this resource.
namestringlength1–512Human-readable name for this resource.
statusstringStatus value to assign to this resource.
definitionobjectStructured definition for this resource.
sampleValuesobjectnullableExample values used to preview this template field.
Responses
200Success
dataobjectrequiredStructured data carried by this object.
Show 11 child fields
Show 3 headers
400A path, query, or request-body value did not pass validation.
401Missing/invalid credential for this audience.
403Authenticated but lacks the required scope/role/audience.
404The requested resource was not found inside the authenticated team or project scope.
curl -X PATCH "https://api.polymorfa.com/platform/templates/<templateId>" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Polymorfa-Version: 2026-09-22" \
-H "Content-Type: application/json" \
-d '{
"projectId": "00000000-0000-4000-8000-000000000000"
}'{
"data": {
"id": "00000000-0000-4000-8000-000000000000",
"createdAt": 0,
"name": "string",
"category": "string",
"language": "string",
"status": "string",
"kind": "string",
"definition": {},
"sampleValues": {},
"cloudLinks": [
{}
],
"updatedAt": 0
}
}Preview project template
- Base URL
https://api.polymorfa.com- Required permission
templates:read
Path parameters
projectSlugstringrequiredSpecifies project slug for this path parameter.
idstringrequiredIdentifier for this resource.
Body
valuesobjectStructured values values for this native preview message template request.
surfacestringSpecifies surface for this native preview message template request.
Allowed valuescloudwhatsmeowsandbox
Responses
200Rendered
successbooleanrequiredWhether the request succeeded.
Allowed valuestruedataobjectrequiredStructured data carried by this object.
Show 3 headers
400Bad request — request body or params failed validation
401Missing or invalid authentication token
403Authenticated but not permitted (missing scope or rule violation)
404Resource not found
500Internal server error
curl -X POST "https://api.polymorfa.com/messaging/projects/<projectSlug>/templates/<id>/preview" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Polymorfa-Version: 2026-09-22" \
-H "Content-Type: application/json" \
-d '{
"values": {},
"surface": "cloud"
}'{
"success": true,
"data": {}
}Submit project template for approval
- Base URL
https://api.polymorfa.com- Required permission
templates:manage
Accepts any number, so one integration handles both connection types; check submission in the response. A Cloud API number needs Meta approval: the template is rendered into a Meta create-template payload, submitted through that number, recorded as a per-number approval pointer (cloudLinks), and returned with submission.status PENDING. Read the Number's template catalog for Meta's review result. Any other number needs no review: nothing is sent to Meta and the template is returned with submission.status APPROVED and submission.autoApproved true. Incomplete or invalid definitions return 400 for every number; passing local validation does not guarantee Meta approval.
Path parameters
projectSlugstringrequiredSpecifies project slug for this path parameter.
idstringrequiredIdentifier for this resource.
Body
sessionstringrequiredmin length1Identifier of the connected Polymorfa session.
Responses
200Submitted to Meta (Cloud API number) or approved automatically (any other number)
successbooleanrequiredWhether the request succeeded.
Allowed valuestruedataobjectrequiredStructured data carried by this object.
Show 12 child fields
Show 3 headers
400Bad request — request body or params failed validation
401Missing or invalid authentication token
403Authenticated but not permitted (missing scope or rule violation)
404Resource not found
500Internal server error
curl -X POST "https://api.polymorfa.com/messaging/projects/<projectSlug>/templates/<id>/submit" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Polymorfa-Version: 2026-09-22" \
-H "Content-Type: application/json" \
-d '{
"session": "string"
}'{
"success": true,
"data": {
"id": "string",
"name": "string",
"category": "string",
"language": "string",
"status": "string",
"kind": "string",
"cloudLinks": [
null
],
"createdAt": 0,
"updatedAt": 0,
"submission": {
"session": "string",
"status": "PENDING",
"autoApproved": true,
"metaTemplateId": "string"
}
}
}Delete project template
- Base URL
https://api.polymorfa.com- Required permission
templates:manage
Path parameters
projectSlugstringrequiredSpecifies project slug for this path parameter.
idstringrequiredIdentifier for this resource.
Responses
200Deleted
successbooleanrequiredWhether the request succeeded.
messagestringHuman-readable message associated with this result.
Show 3 headers
400Bad request — request body or params failed validation
401Missing or invalid authentication token
403Authenticated but not permitted (missing scope or rule violation)
404Resource not found
500Internal server error
curl -X DELETE "https://api.polymorfa.com/messaging/projects/<projectSlug>/templates/<id>" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Polymorfa-Version: 2026-09-22"{
"success": true
}Delete message template
- Base URL
https://api.polymorfa.com- Required permission
templates:manage
Deletes one message-template draft from the specified project.
Requires templates:manage. Project tokens only access resources in their own project.
Path parameters
templateIdstringrequiredIdentifier of the message template.
Query parameters
projectIdstringrequiredIdentifier of the Polymorfa project that owns this resource.
Responses
200Success
dataobjectrequiredStructured data carried by this object.
Show 1 child field
Show 3 headers
400A path, query, or request-body value did not pass validation.
401Missing/invalid credential for this audience.
403Authenticated but lacks the required scope/role/audience.
404The requested resource was not found inside the authenticated team or project scope.
curl -X DELETE "https://api.polymorfa.com/platform/templates/<templateId>?projectId=<projectId>" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Polymorfa-Version: 2026-09-22"{
"data": {
"ok": true
}
}