NOTIFY
API reference Sign in

Message templates

Built from the list the API itself uses, so it is never out of date.

Every SMS NOTIFY sends is one of these fixed sentences, in Georgian or English, under the sender name NOTIFY. You choose the template and fill its blanks; NOTIFY checks each blank before anything is sent, and no blank takes free words: a blank is digits, one of NOTIFY's own choices, or a name you keep on your dashboard. A value that breaks its blank's rule is refused with 400 invalid_variables, and nothing is sent or charged. How to send one: the API reference.

Codes

One-time codes, to any Georgian mobile number. To have NOTIFY make and check the code itself, use the verification API (/api#verifications).

verification_codeAny number

A one-time code that confirms a phone number or an action.

English
Your verification code is {code}. Do not share it with anyone.
Georgian
თქვენი დამადასტურებელი კოდია {code}. არავის გაუზიაროთ.
code
4 to 8 digits
POST /v1/messages
{
  "to": "+995591234567",
  "template": "verification_code",
  "variables": {
    "code": "482913"
  },
  "locale": "en"
}

login_codeAny number

A one-time code for signing in.

English
Your sign-in code is {code}. If you did not request it, ignore this message.
Georgian
შესვლის კოდი: {code}. თუ არ მოგითხოვიათ, გამოტოვეთ ეს შეტყობინება.
code
4 to 8 digits
POST /v1/messages
{
  "to": "+995591234567",
  "template": "login_code",
  "variables": {
    "code": "482913"
  },
  "locale": "en"
}

password_reset_codeAny number

A one-time code for resetting a password, with its lifetime.

English
Your password reset code is {code}. It expires in {minutes} minutes.
Georgian
პაროლის აღდგენის კოდი: {code}. მოქმედებს {minutes} წუთი.
code
4 to 8 digits
minutes
a whole number from 1 to 999
POST /v1/messages
{
  "to": "+995591234567",
  "template": "password_reset_code",
  "variables": {
    "code": "482913",
    "minutes": "10"
  },
  "locale": "en"
}

Team alerts

Alerts to your own team, and only to numbers confirmed on your project's team. You add a number on the dashboard's team page; NOTIFY texts it a code, and the person reads the code to you, which is how they agree to receive your alerts. Your API keys can send to these numbers but can never add one. A team alert to any other number is refused with 403 recipient_not_on_team, and nothing is sent or charged. With a test key (sk_test_) team alerts go to the test numbers +995512345670 to +995512345679 only, and are simulated. At most 30 team alerts an hour go to one number.

service_downYour team only

Tells your team that one of your services is down.

English
Alert: {service} is down.
Georgian
გაფრთხილება: {service} არ მუშაობს.
service
a name on your project's list, kept on the dashboard's team page: 1 to 24 Latin letters, digits and hyphens, starting with a letter or a digit, with at most 4 digits in all. With a test key, any name that follows these rules.
POST /v1/messages
{
  "to": "+995591234567",
  "template": "service_down",
  "variables": {
    "service": "payments-api"
  },
  "locale": "en"
}

service_upYour team only

Tells your team that a service is up again.

English
Resolved: {service} is up again.
Georgian
აღდგა: {service} ისევ მუშაობს.
service
a name on your project's list, kept on the dashboard's team page: 1 to 24 Latin letters, digits and hyphens, starting with a letter or a digit, with at most 4 digits in all. With a test key, any name that follows these rules.
POST /v1/messages
{
  "to": "+995591234567",
  "template": "service_up",
  "variables": {
    "service": "payments-api"
  },
  "locale": "en"
}

incident_openedYour team only

Tells your team that an urgent incident needs attention.

English
Urgent: incident {incident} needs attention.
Georgian
სასწრაფო: ინციდენტი {incident} ყურადღებას საჭიროებს.
incident
1 to 8 digits
POST /v1/messages
{
  "to": "+995591234567",
  "template": "incident_opened",
  "variables": {
    "incident": "4821"
  },
  "locale": "en"
}

support_ticket_urgentYour team only

Tells your team that an urgent support ticket is waiting.

English
Urgent: support ticket {ticket} is waiting for a reply.
Georgian
სასწრაფო: მხარდაჭერის მოთხოვნა {ticket} პასუხს ელოდება.
ticket
1 to 8 digits
POST /v1/messages
{
  "to": "+995591234567",
  "template": "support_ticket_urgent",
  "variables": {
    "ticket": "4821"
  },
  "locale": "en"
}

job_failedYour team only

Tells your team that a scheduled job did not finish.

English
Failed: scheduled job {job} did not finish.
Georgian
შეცდომა: დაგეგმილი ამოცანა {job} ვერ დასრულდა.
job
a name on your project's list, kept on the dashboard's team page: 1 to 24 Latin letters, digits and hyphens, starting with a letter or a digit, with at most 4 digits in all. With a test key, any name that follows these rules.
POST /v1/messages
{
  "to": "+995591234567",
  "template": "job_failed",
  "variables": {
    "job": "payments-api"
  },
  "locale": "en"
}

agent_alertYour team only

Tells your team that your AI agent has new updates.

English
{agent}: {count} new updates. Check your app.
English, a count of 1
{agent}: {count} new update. Check your app.
Georgian
{agent}: {count} ახალი განახლება. შეამოწმეთ აპლიკაცია.
agent
one of your_agent (shown as “Your agent”, “თქვენი აგენტი”), ai_assistant (shown as “AI assistant”, “AI ასისტენტი”)
count
a whole number from 1 to 99
POST /v1/messages
{
  "to": "+995591234567",
  "template": "agent_alert",
  "variables": {
    "agent": "your_agent",
    "count": "3"
  },
  "locale": "en"
}