API Reference - StaryaAI

Create Communication Template

post
https://backend.psyco.ai/enterprise/staging/communication/template

Creates a new communication template for the authenticated tenant.

Feature Flag Required: For create templates your tenant must be enabled this feature.

Template Approval Flow

  1. Initial Submission: The template is created with status pending and submitted to WhatsApp
  2. Immediate Polling: The API will poll WhatsApp for up to ~10 seconds to check approval status
  3. Asynchronous Processing: If not approved within ~10 seconds, template remains pending
  4. Background Updates: A cron job checks pending templates every 5 minutes
  5. Status Updates: Template status will be updated to approved, rejected, or failed (if >48h pending)

Status Values

  • pending: Awaiting WhatsApp approval (may take up to 48 hours)
  • approved: Template approved and ready to use
  • rejected: Template rejected by WhatsApp (check database for rejection reason)
  • failed: Approval timeout after 48 hours without response

Note: Most templates are approved within minutes, but WhatsApp may take up to 48 hours.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Template friendly name (will be normalized).
A timestamp suffix (_yyyyMMddHHmmss) is automatically added to ensure uniqueness.

Validation Rules:

  • Must be lowercase
  • No spaces allowed
  • Only alphanumeric characters and underscores
  • Cannot start or end with underscore
  • Maximum 255 characters
  • Must be unique
content
object
required

Template content structure (depends on contentType)

For TEXT: { body: string }
For MEDIA: { body?: string, media: URL[] }
For QUICK_REPLY: { body?: string, actions: object[] }
For CALL_TO_ACTION: { body?: string, actions: object[] }

string
enum
required

Template language code

Allowed:
variables
object

Optional. Template variables mapping (key: variable position, value: example).
Used for WhatsApp approval process.
Only required if the template body contains placeholders ({{1}}, {{2}}, etc).

string
enum
required

Internal template category

Allowed:
string
enum
required

Template content type

Allowed:
uuid
required

Agent ID that will send the template

Responses

Updated about 2 months ago

Did this page help you?
Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 months ago

Did this page help you?