Skip to main content

Getting started with message templates

Using SMS message templates instead of crafting messages from scratch offers tangible benefits that can positively impact your business's SMS communication strategy. Through Falu's message templates, you can save time, maintain consistency, reduce errors, meet compliance requirements, and scale your messaging operations effectively.

Falu allows you to create custom templates for use in the body of your messages.

Creating a message template​

You can create a message template from either your dashboard or through the message_templates endpoint.

Creating a template through the dashboard​

In your dashboard under the Messaging menu, navigate to Templates >> Create Template.

img-docs-messages-templates-create-template-dashboard

Fill in the template details in the window that opens.

  1. Provide an alias, which is a name or unique string identifier for the template. Check out Using a template alias for more details.
  2. Give the template a Description, for example, its purpose.
  3. Create the Template Body, which will be used in the body of your message. Refer to Template syntax for more details on the syntax of templates and how Falu interprets them.
  4. Preview your template before, finally, clicking on the Create Template button.

Creating a template through the API​

You can also create a template by making the following POST API call to https://api.falu.io/v1/message_templates:

curl -X POST 'https://api.falu.io/v1/message_templates' \
   --header 'Authorization: Bearer YOUR_SECRET_KEY' \
   --header 'X-Falu-Version: 2022-09-01' \
   --header 'Content-Type: application/json' \
   --data '{
      "alias": " ",
      "description": " ",
      "body": " "
   }

Similar to when creating a template through the dashboard, make sure to provide the alias, description, and body parameters.

Viewing your message templates​

You can view all previously created message templates associated with your account either through your dashboard or API.

View templates from the dashboard​

You can view all your message templates under the Messaging >> Templates menus.

img-docs-messages-templates-view-templates-dashboard

Clicking on a particular template will reveal more details about it, including its unique template ID.

View templates through the API​

You can also view all your templates by making a GET API call to https://api.falu.io/v1/message_templates:

curl -X GET 'https://api.falu.io/v1/message_templates' \
--header 'Authorization: Bearer YOUR_SECRET_KEY' \
--header 'X-Falu-Version: 2022-09-01'

Deleting a message template​

You can also delete a template that you no longer require.

Deleting a template through the dashboard​

To delete a message template through your dashboard, navigate to view your templates and click on the delete icon under the Actions tab.

img-docs-messages-templates-delete-template-dashboard

Delete a template through the API​

You can also delete a template by making a DELETE API call to https://api.falu.io/v1/message_templates:

curl --location --request DELETE 'https://api.falu.io/v1/message_templates/TEMPLATE_ID' \
--header 'Authorization: Bearer YOUR_SECRET_KEY' \
--header 'X-Falu-Version: 2022-09-01'
Last updated on