Sinch Template Management API v2

openapi: 3.2.0
info:
  contact:
    email: support@sinch.com
    name: support at sinch
  description: "# Overview\nThe Template Management API offers a way to manage templates that can be used together with the Conversation API. Note that you may also use the Message Composer tool on the [Sinch Customer Dashboard](https://dashboard.sinch.com/convapi/message-composer) to [manage templates](https://community.sinch.com/t5/Conversation-API/How-do-I-use-Message-Composer-to-create-omni-channel-message/ta-p/9890).\n\nOne can view a template as a pre-defined message that can optionally contain some parameters to facilitate some customization of the pre-defined message. This feature can, for instance, be used to construct a generic customer welcome message where the customer's name can be injected via a parameter. It's also possible to provide translations to different languages when creating a template to make it possible to reuse one template for different languages.\n\n## Base URL\n\nThe following URLs can be used when making calls to the Template Management API.\n\n|Server|URL|\n|------|---|\n|Template Management API (US Production)|`https://us.template.api.sinch.com`|\n|Template Management API (EU Production)|`https://eu.template.api.sinch.com`|\n|Template Management API (BR Production)|`https://br.template.api.sinch.com`|\n\n## Template Management API Version 2\n\n{% admonition type=\"info\" name=\"Note:\" %}\n\nAs of January 31, 2026, Version 1 endpoints for managing message templates have been deprecated and are no longer accessible. Version 2 is recommended and is the only version currently accessible.\n\n{% /admonition %}\n\nVersion 2 of the Template Management API was released on September 4, 2023. We recommend using this version of the Template Management API for all template management activities via API calls. In addition to the feature set included with Version 1, Version 2 also includes:\n\n  - Strongly typed `translations` field content, allowing the user to define the message using the same JSON structure used to define messages in a [send message request](https://developers.sinch.com/docs/conversation/api-reference/conversation/messages/messages_sendmessage#messages/messages_sendmessage/t=request&path=correlation_id)\n  - Improved validation\n  - The option to override the omni-channel template configuration with a channel-specific template (for channels on which channel-specific templates can be created) using the `channel_template_overrides` field\n\n## Accessing the Template Management API\n\nThe first step towards interacting with the Template Management API is to create an account on the [Sinch Customer Dashboard](https://dashboard.sinch.com). The next step is to create an Access Key under the Settings tab and note down the provided Key ID and Key Secret in a secure location. Also make sure to remember the Project ID since your template will be placed under the provided Project ID.\n\nThe Key ID and the Key Secret are then used in the following way to obtain a valid OAuth2 Access Token that will be used to authenticate towards the Template Management API.\n```console\ncurl https://us.auth.sinch.com/oauth2/token -d grant_type=client_credentials --user <key_id>:<key_secret>\n```\n\nThe obtained Access Token is then used in the following way to interact with the Template Management API:\n```console\ncurl https://us.template.api.sinch.com/v1/projects/<Project ID>/templates -H \"Authorization: Bearer <Access Token>\"\n```\n\nNote that the obtained token above is only valid when interacting with the Template Management API in the US region. Another Access Token must be obtained from the FQDN eu.auth.sinch.com to interact with the Template Management API in the EU region(FQDN eu.template.api.sinch.com).\n"
  title: Template Management API
  version: '2.0'
  license:
    name: MIT
    url: https://www.sinch.com/legal
security:
- Basic: []


# --- truncated at 32 KB (70 KB total) ---
# Full source: https://artifacts.apis.io/sinch/openapi/sinch-template-management-api-openapi.yml