find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/infobip-platform-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Infobip OpenAPI Specification Platform API
  description: OpenAPI Specification that contains all public endpoints and webhooks.
  contact:
    name: Infobip support
    email: support@infobip.com
  version: 3.210.0
  x-generatedAt: '2026-07-23T15:23:37.825639538Z'
tags:
- name: platform
  description: 'Modular tools to scale and automate your business.

    '
  x-type: category
  x-displayName: Platform
paths:
  /2fa/2/applications:
    get:
      tags:
      - platform
      summary: Get all 2FA applications
      description: An application is a container for 2FA message templates. Use this method to list your applications.
      externalDocs:
        description: Learn more about the workflow and setup
        url: https://www.infobip.com/docs/2fa-service/general-2fa-otp-setup
      operationId: get-2fa-applications
      responses:
        '200':
          description: successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/17363474057d152577564d8587b079aa7bdd070a3f49746aea3319eb57a5830c.ApplicationResponse'
              examples:
                Multiple applications response:
                  summary: Multiple applications response
                  value:
                  - applicationId: 0933F3BC087D2A617AC6DCB2EF5B8A61
                    name: Test application BASIC 1
                    configuration:
                      pinAttempts: 10
                      allowMultiplePinVerifications: true
                      pinTimeToLive: 2h
                      verifyPinLimit: 1/3s
                      sendPinPerApplicationLimit: 10000/1d
                      sendPinPerPhoneNumberLimit: 3/1d
                    enabled: true
                  - applicationId: 5F04FACFAA4978F62FCAEBA97B37E90F
                    name: Test application BASIC 2
                    configuration:
                      pinAttempts: 12
                      allowMultiplePinVerifications: true
                      pinTimeToLive: 10m
                      verifyPinLimit: 2/1s
                      sendPinPerApplicationLimit: 10000/1d
                      sendPinPerPhoneNumberLimit: 5/1h
                    enabled: true
                  - applicationId: B450F966A8EF017180F148AF22C42642
                    name: Test application BASIC 3
                    configuration:
                      pinAttempts: 15
                      allowMultiplePinVerifications: true
                      pinTimeToLive: 1h
                      verifyPinLimit: 30/10s
                      sendPinPerApplicationLimit: 10000/3d
                      sendPinPerPhoneNumberLimit: 10/20m
                    enabled: true
            application/xml:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/17363474057d152577564d8587b079aa7bdd070a3f49746aea3319eb57a5830c.ApplicationResponse'
              examples:
                Multiple applications response:
                  summary: Multiple applications response
                  value: "<?xml version=\"1.0\" encoding=\"UTF-8\"?><ApplicationResponses>\n  <item>\n    <applicationId>0933F3BC087D2A617AC6DCB2EF5B8A61</applicationId>\n    <name>Test application BASIC 1</name>\n    <configuration>\n      <pinAttempts>10</pinAttempts>\n      <allowMultiplePinVerifications>true</allowMultiplePinVerifications>\n      <pinTimeToLive>2h</pinTimeToLive>\n      <verifyPinLimit>1/3s</verifyPinLimit>\n      <sendPinPerApplicationLimit>10000/1d</sendPinPerApplicationLimit>\n      <sendPinPerPhoneNumberLimit>3/1d</sendPinPerPhoneNumberLimit>\n    </configuration>\n    <enabled>true</enabled>\n  </item>\n  <item>\n    <applicationId>5F04FACFAA4978F62FCAEBA97B37E90F</applicationId>\n    <name>Test application BASIC 2</name>\n    <configuration>\n      <pinAttempts>12</pinAttempts>\n      <allowMultiplePinVerifications>true</allowMultiplePinVerifications>\n      <pinTimeToLive>10m</pinTimeToLive>\n      <verifyPinLimit>2/1s</verifyPinLimit>\n      <sendPinPerApplicationLimit>10000/1d</sendPinPerApplicationLimit>\n      <sendPinPerPhoneNumberLimit>5/1h</sendPinPerPhoneNumberLimit>\n    </configuration>\n    <enabled>true</enabled>\n  </item>\n  <item>\n    <applicationId>B450F966A8EF017180F148AF22C42642</applicationId>\n    <name>Test application BASIC 3</name>\n    <configuration>\n      <pinAttempts>15</pinAttempts>\n      <allowMultiplePinVerifications>true</allowMultiplePinVerifications>\n      <pinTimeToLive>1h</pinTimeToLive>\n      <verifyPinLimit>30/10s</verifyPinLimit>\n      <sendPinPerApplicationLimit>10000/3d</sendPinPerApplicationLimit>\n      <sendPinPerPhoneNumberLimit>10/20m</sendPinPerPhoneNumberLimit>\n    </configuration>\n    <enabled>true</enabled>\n  </item>\n</ApplicationResponses>\n"
        '401':
          $ref: '#/components/responses/ApiException401'
        '403':
          $ref: '#/components/responses/ApiException403'
        '429':
          $ref: '#/components/responses/ApiException429'
        4XX:
          description: Error responses
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/96ea7b6cea267e43daadde063d93b8799cdb795baa0e9344573e0f63283595e0.ApiException'
            application/xml:
              schema:
                $ref: '#/components/schemas/96ea7b6cea267e43daadde063d93b8799cdb795baa0e9344573e0f63283595e0.ApiException'
        '500':
          $ref: '#/components/responses/ApiException500'
        5XX:
          description: Error responses
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/96ea7b6cea267e43daadde063d93b8799cdb795baa0e9344573e0f63283595e0.ApiException'
            application/xml:
              schema:
                $ref: '#/components/schemas/96ea7b6cea267e43daadde063d93b8799cdb795baa0e9344573e0f63283595e0.ApiException'
      security:
      - Basic: []
      - APIKeyHeader: []
      - IBSSOTokenHeader: []
      - OAuth2: []
      x-scopes:
      - 2fa:manage
      x-throttling-info:
      - type: time
        numberOfRequests: 50
        numberOfTimeUnits: 10
        timeUnit: m
    post:
      tags:
      - platform
      summary: Create 2FA application
      description: Create and configure a new 2FA application.
      externalDocs:
        description: Learn more about the workflow and setup
        url: https://www.infobip.com/docs/2fa-service/general-2fa-otp-setup
      operationId: create-2fa-application
      requestBody:
        content:
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/17363474057d152577564d8587b079aa7bdd070a3f49746aea3319eb57a5830c.ApplicationRequest'
            examples:
              Application request:
                summary: Application request
                value:
                  name: 2fa application name
                  enabled: true
                  configuration:
                    pinAttempts: 5
                    allowMultiplePinVerifications: true
                    pinTimeToLive: 10m
                    verifyPinLimit: 2/4s
                    sendPinPerApplicationLimit: 5000/12h
                    sendPinPerPhoneNumberLimit: 2/1d
          application/xml:
            schema:
              allOf:
              - $ref: '#/components/schemas/17363474057d152577564d8587b079aa7bdd070a3f49746aea3319eb57a5830c.ApplicationRequest'
            examples:
              Application request:
                summary: Application request
                value: "<?xml version=\"1.0\" encoding=\"UTF-8\"?><ApplicationRequest>\n  <name>2fa application name</name>\n  <enabled>true</enabled>\n  <configuration>\n    <pinAttempts>5</pinAttempts>\n    <allowMultiplePinVerifications>true</allowMultiplePinVerifications>\n    <pinTimeToLive>10m</pinTimeToLive>\n    <verifyPinLimit>2/4s</verifyPinLimit>\n    <sendPinPerApplicationLimit>5000/12h</sendPinPerApplicationLimit>\n    <sendPinPerPhoneNumberLimit>2/1d</sendPinPerPhoneNumberLimit>\n  </configuration>\n</ApplicationRequest>\n"
      responses:
        '201':
          description: successful response
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/17363474057d152577564d8587b079aa7bdd070a3f49746aea3319eb57a5830c.ApplicationResponse'
              examples:
                Creating new application response:
                  summary: Creating new application response
                  value:
                    applicationId: '1234567'
                    name: Application name
                    configuration:
                      pinAttempts: 5
                      allowMultiplePinVerifications: true
                      pinTimeToLive: 10m
                      verifyPinLimit: 2/4s
                      sendPinPerApplicationLimit: 5000/12h
                      sendPinPerPhoneNumberLimit: 2/1d
                    enabled: true
            application/xml:
              schema:
                allOf:
                - $ref: '#/components/schemas/17363474057d152577564d8587b079aa7bdd070a3f49746aea3319eb57a5830c.ApplicationResponse'
              examples:
                Creating new application response:
                  summary: Creating new application response
                  value: "<?xml version=\"1.0\" encoding=\"UTF-8\"?><ApplicationResponse>\n  <applicationId>1234567</applicationId>\n  <name>Application name</name>\n  <configuration>\n    <pinAttempts>5</pinAttempts>\n    <allowMultiplePinVerifications>true</allowMultiplePinVerifications>\n    <pinTimeToLive>10m</pinTimeToLive>\n    <verifyPinLimit>2/4s</verifyPinLimit>\n    <sendPinPerApplicationLimit>5000/12h</sendPinPerApplicationLimit>\n    <sendPinPerPhoneNumberLimit>2/1d</sendPinPerPhoneNumberLimit>\n  </configuration>\n  <enabled>true</enabled>\n</ApplicationResponse>\n"
        '400':
          $ref: '#/components/responses/ApiException400'
        '401':
          $ref: '#/components/responses/ApiException401'
        '403':
          $ref: '#/components/responses/ApiException403'
        '429':
          $ref: '#/components/responses/ApiException429'
        4XX:
          description: Error responses
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/96ea7b6cea267e43daadde063d93b8799cdb795baa0e9344573e0f63283595e0.ApiException'
            application/xml:
              schema:
                $ref: '#/components/schemas/96ea7b6cea267e43daadde063d93b8799cdb795baa0e9344573e0f63283595e0.ApiException'
        '500':
          $ref: '#/components/responses/ApiException500'
        5XX:
          description: Error responses
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/96ea7b6cea267e43daadde063d93b8799cdb795baa0e9344573e0f63283595e0.ApiException'
            application/xml:
              schema:
                $ref: '#/components/schemas/96ea7b6cea267e43daadde063d93b8799cdb795baa0e9344573e0f63283595e0.ApiException'
      security:
      - Basic: []
      - APIKeyHeader: []
      - IBSSOTokenHeader: []
      - OAuth2: []
      x-scopes:
      - 2fa:manage
      x-throttling-info:
      - type: time
        numberOfRequests: 20
        numberOfTimeUnits: 10
        timeUnit: m
  /2fa/2/applications/{appId}:
    get:
      tags:
      - platform
      summary: Get 2FA application
      description: Get a single 2FA application to see its configuration details.
      externalDocs:
        description: Learn more about the workflow and setup
        url: https://www.infobip.com/docs/2fa-service/general-2fa-otp-setup
      operationId: get-2fa-application
      parameters:
      - name: appId
        in: path
        description: ID of application for which configuration view was requested.
        required: true
        style: simple
        explode: false
        schema:
          type: string
        example: 0933F3BC087D2A617AC6DCB2EF5B8A61
      responses:
        '200':
          description: successful response
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/17363474057d152577564d8587b079aa7bdd070a3f49746aea3319eb57a5830c.ApplicationResponse'
              examples:
                Single application response:
                  summary: Single application response
                  value:
                    applicationId: '1234567'
                    name: Application name
                    configuration:
                      pinAttempts: 5
                      allowMultiplePinVerifications: true
                      pinTimeToLive: 10m
                      verifyPinLimit: 2/4s
                      sendPinPerApplicationLimit: 5000/12h
                      sendPinPerPhoneNumberLimit: 2/1d
                    enabled: true
            application/xml:
              schema:
                allOf:
                - $ref: '#/components/schemas/17363474057d152577564d8587b079aa7bdd070a3f49746aea3319eb57a5830c.ApplicationResponse'
              examples:
                Single application response:
                  summary: Single application response
                  value: "<?xml version=\"1.0\" encoding=\"UTF-8\"?><ApplicationResponse>\n  <applicationId>1234567</applicationId>\n  <name>Application name</name>\n  <configuration>\n    <pinAttempts>5</pinAttempts>\n    <allowMultiplePinVerifications>true</allowMultiplePinVerifications>\n    <pinTimeToLive>10m</pinTimeToLive>\n    <verifyPinLimit>2/4s</verifyPinLimit>\n    <sendPinPerApplicationLimit>5000/12h</sendPinPerApplicationLimit>\n    <sendPinPerPhoneNumberLimit>2/1d</sendPinPerPhoneNumberLimit>\n  </configuration>\n  <enabled>true</enabled>\n</ApplicationResponse>\n"
        '401':
          $ref: '#/components/responses/ApiException401'
        '403':
          $ref: '#/components/responses/ApiException403'
        '404':
          $ref: '#/components/responses/ApiException404'
        '429':
          $ref: '#/components/responses/ApiException429'
        4XX:
          description: Error responses
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/96ea7b6cea267e43daadde063d93b8799cdb795baa0e9344573e0f63283595e0.ApiException'
            application/xml:
              schema:
                $ref: '#/components/schemas/96ea7b6cea267e43daadde063d93b8799cdb795baa0e9344573e0f63283595e0.ApiException'
        '500':
          $ref: '#/components/responses/ApiException500'
        5XX:
          description: Error responses
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/96ea7b6cea267e43daadde063d93b8799cdb795baa0e9344573e0f63283595e0.ApiException'
            application/xml:
              schema:
                $ref: '#/components/schemas/96ea7b6cea267e43daadde063d93b8799cdb795baa0e9344573e0f63283595e0.ApiException'
      security:
      - Basic: []
      - APIKeyHeader: []
      - IBSSOTokenHeader: []
      - OAuth2: []
      x-scopes:
      - 2fa:manage
      x-throttling-info:
      - type: time
        numberOfRequests: 100
        numberOfTimeUnits: 10
        timeUnit: m
    put:
      tags:
      - platform
      summary: Update 2FA application
      description: Change configuration options for your existing 2FA application.
      externalDocs:
        description: Learn more about the workflow and setup
        url: https://www.infobip.com/docs/2fa-service/general-2fa-otp-setup
      operationId: update-2fa-application
      parameters:
      - name: appId
        in: path
        description: ID of application that should be updated.
        required: true
        style: simple
        explode: false
        schema:
          type: string
        example: 0933F3BC087D2A617AC6DCB2EF5B8A61
      requestBody:
        content:
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/17363474057d152577564d8587b079aa7bdd070a3f49746aea3319eb57a5830c.ApplicationRequest'
            examples:
              Application request:
                summary: Application request
                value:
                  name: 2fa application name
                  enabled: true
                  configuration:
                    pinAttempts: 5
                    allowMultiplePinVerifications: true
                    pinTimeToLive: 10m
                    verifyPinLimit: 2/4s
                    sendPinPerApplicationLimit: 5000/12h
                    sendPinPerPhoneNumberLimit: 2/1d
          application/xml:
            schema:
              allOf:
              - $ref: '#/components/schemas/17363474057d152577564d8587b079aa7bdd070a3f49746aea3319eb57a5830c.ApplicationRequest'
            examples:
              Application request:
                summary: Application request
                value: "<?xml version=\"1.0\" encoding=\"UTF-8\"?><ApplicationRequest>\n  <name>2fa application name</name>\n  <enabled>true</enabled>\n  <configuration>\n    <pinAttempts>5</pinAttempts>\n    <allowMultiplePinVerifications>true</allowMultiplePinVerifications>\n    <pinTimeToLive>10m</pinTimeToLive>\n    <verifyPinLimit>2/4s</verifyPinLimit>\n    <sendPinPerApplicationLimit>5000/12h</sendPinPerApplicationLimit>\n    <sendPinPerPhoneNumberLimit>2/1d</sendPinPerPhoneNumberLimit>\n  </configuration>\n</ApplicationRequest>\n"
      responses:
        '200':
          description: successful response
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/17363474057d152577564d8587b079aa7bdd070a3f49746aea3319eb57a5830c.ApplicationResponse'
              examples:
                Updating application response:
                  summary: Updating application response
                  value:
                    applicationId: '1234567'
                    name: Application name
                    configuration:
                      pinAttempts: 5
                      allowMultiplePinVerifications: true
                      pinTimeToLive: 10m
                      verifyPinLimit: 2/4s
                      sendPinPerApplicationLimit: 5000/12h
                      sendPinPerPhoneNumberLimit: 2/1d
                    enabled: true
            application/xml:
              schema:
                allOf:
                - $ref: '#/components/schemas/17363474057d152577564d8587b079aa7bdd070a3f49746aea3319eb57a5830c.ApplicationResponse'
              examples:
                Updating application response:
                  summary: Updating application response
                  value: "<?xml version=\"1.0\" encoding=\"UTF-8\"?><ApplicationResponse>\n  <applicationId>1234567</applicationId>\n  <name>Application name</name>\n  <configuration>\n    <pinAttempts>5</pinAttempts>\n    <allowMultiplePinVerifications>true</allowMultiplePinVerifications>\n    <pinTimeToLive>10m</pinTimeToLive>\n    <verifyPinLimit>2/4s</verifyPinLimit>\n    <sendPinPerApplicationLimit>5000/12h</sendPinPerApplicationLimit>\n    <sendPinPerPhoneNumberLimit>2/1d</sendPinPerPhoneNumberLimit>\n  </configuration>\n  <enabled>true</enabled>\n</ApplicationResponse>\n"
        '400':
          $ref: '#/components/responses/ApiException400'
        '401':
          $ref: '#/components/responses/ApiException401'
        '403':
          $ref: '#/components/responses/ApiException403'
        '404':
          $ref: '#/components/responses/ApiException404'
        '429':
          $ref: '#/components/responses/ApiException429'
        4XX:
          description: Error responses
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/96ea7b6cea267e43daadde063d93b8799cdb795baa0e9344573e0f63283595e0.ApiException'
            application/xml:
              schema:
                $ref: '#/components/schemas/96ea7b6cea267e43daadde063d93b8799cdb795baa0e9344573e0f63283595e0.ApiException'
        '500':
          $ref: '#/components/responses/ApiException500'
        5XX:
          description: Error responses
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/96ea7b6cea267e43daadde063d93b8799cdb795baa0e9344573e0f63283595e0.ApiException'
            application/xml:
              schema:
                $ref: '#/components/schemas/96ea7b6cea267e43daadde063d93b8799cdb795baa0e9344573e0f63283595e0.ApiException'
      security:
      - Basic: []
      - APIKeyHeader: []
      - IBSSOTokenHeader: []
      - OAuth2: []
      x-scopes:
      - 2fa:manage
      x-throttling-info:
      - type: time
        numberOfRequests: 40
        numberOfTimeUnits: 10
        timeUnit: m
  /2fa/2/applications/{appId}/messages:
    get:
      tags:
      - platform
      summary: Get all 2FA message templates
      description: List all message templates in a 2FA application.
      externalDocs:
        description: Learn more about the workflow and setup
        url: https://www.infobip.com/docs/2fa-service/general-2fa-otp-setup
      operationId: get-2fa-message-templates
      parameters:
      - name: appId
        in: path
        description: ID of application for which requested message was created.
        required: true
        style: simple
        explode: false
        schema:
          type: string
        example: 0933F3BC087D2A617AC6DCB2EF5B8A61
      responses:
        '200':
          description: successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.Message'
              examples:
                Multiple message template response:
                  summary: Multiple message template response
                  value:
                  - messageId: A89CE542F3F12
                    applicationId: 32G5F37A635KJ8BHJ675435E3A6EA434
                    messageText: Your pin is {{pin}}
                    pinLength: 4
                    pinType: ALPHANUMERIC
                    senderId: Infobip 2FA
                  - messageId: AF33289C815F8
                    applicationId: A635KJ8BHJ6754432G5F3735E3A6EA43
                    messageText: Your pin is {{pin}}
                    pinLength: 4
                    pinType: ALPHANUMERIC
                    language: en
                    voiceName: Joanna
                    senderId: Infobip 2FA
                    repeatDTMF: 1#
                    speechRate: 1.0
                  - messageId: 9C815F8AF3328
                    applicationId: HJ675435E3A6EA43432G5F37A635KJ8B
                    pinLength: 4
                    pinType: ALPHANUMERIC
                    from: company@example.com
                    emailTemplateId: 1234
                    landingPageId: '1_23456'
            application/xml:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.Message'
              examples:
                Multiple message template response:
                  summary: Multiple message template response
                  value: "<?xml version=\"1.0\" encoding=\"UTF-8\"?><Messages>\n  <item>\n    <messageId>A89CE542F3F12</messageId>\n    <applicationId>32G5F37A635KJ8BHJ675435E3A6EA434</applicationId>\n    <messageText>Your pin is {{pin}}</messageText>\n    <pinLength>4</pinLength>\n    <pinType>ALPHANUMERIC</pinType>\n    <senderId>Infobip 2FA</senderId>\n  </item>\n  <item>\n    <messageId>AF33289C815F8</messageId>\n    <applicationId>A635KJ8BHJ6754432G5F3735E3A6EA43</applicationId>\n    <messageText>Your pin is {{pin}}</messageText>\n    <pinLength>4</pinLength>\n    <pinType>ALPHANUMERIC</pinType>\n    <language>en</language>\n    <voiceName>Joanna</voiceName>\n    <senderId>Infobip 2FA</senderId>\n    <repeatDTMF>1#</repeatDTMF>\n    <speechRate>1.0</speechRate>\n  </item>\n  <item>\n    <messageId>9C815F8AF3328</messageId>\n    <applicationId>HJ675435E3A6EA43432G5F37A635KJ8B</applicationId>\n    <pinLength>4</pinLength>\n    <pinType>ALPHANUMERIC</pinType>\n    <from>company@example.com</from>\n    <emailTemplateId>1234</emailTemplateId>\n    <landingPageId>1_23456</landingPageId>\n  </item>\n</Messages>\n"
        '401':
          $ref: '#/components/responses/ApiException401'
        '403':
          $ref: '#/components/responses/ApiException403'
        '404':
          $ref: '#/components/responses/ApiException404'
        4XX:
          description: Error responses
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/96ea7b6cea267e43daadde063d93b8799cdb795baa0e9344573e0f63283595e0.ApiException'
            application/xml:
              schema:
                $ref: '#/components/schemas/96ea7b6cea267e43daadde063d93b8799cdb795baa0e9344573e0f63283595e0.ApiException'
        '500':
          $ref: '#/components/responses/ApiException500'
        5XX:
          description: Error responses
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/96ea7b6cea267e43daadde063d93b8799cdb795baa0e9344573e0f63283595e0.ApiException'
            application/xml:
              schema:
                $ref: '#/components/schemas/96ea7b6cea267e43daadde063d93b8799cdb795baa0e9344573e0f63283595e0.ApiException'
      security:
      - Basic: []
      - APIKeyHeader: []
      - IBSSOTokenHeader: []
      - OAuth2: []
      x-scopes:
      - 2fa:manage
    post:
      tags:
      - platform
      summary: Create 2FA SMS or Voice message template
      description: Once you have your [2FA application](#channels/sms/2fa/2fa-configuration/create-2fa-application), create one or more [message templates](#channels/sms/2fa/2fa-configuration/create-2fa-message-template) where your PIN will be dynamically included when you send the PIN message over SMS or Voice.
      externalDocs:
        description: Learn more about the workflow and setup
        url: https://www.infobip.com/docs/2fa-service/general-2fa-otp-setup
      operationId: create-2fa-message-template
      parameters:
      - name: appId
        in: path
        description: ID of application for which requested message was created.
        required: true
        style: simple
        explode: false
        schema:
          type: string
        example: 0933F3BC087D2A617AC6DCB2EF5B8A61
      requestBody:
        content:
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.CreateSmsOrVoiceMessageRequest'
            examples:
              Create message template:
                summary: Create message template
                value:
                  pinType: NUMERIC
                  messageText: Your pin is {{pin}}
                  pinLength: 4
                  language: en
                  voiceName: Joanna
                  senderId: Infobip 2FA
                  repeatDTMF: 1#
                  speechRate: 1.0
              Create message template with placeholders:
                summary: Create message template with placeholders
                description: Create a message template with placeholders that can later be filled with different values for each PIN message
                value:
                  pinType: NUMERIC
                  messageText: Hello {{firstName}} your pin is {{pin}}
                  pinLength: 4
                  language: en
                  voiceName: Joanna
                  senderId: Infobip 2FA
                  repeatDTMF: 1#
                  speechRate: 1.0
              Create message template with DLT parameters:
                summary: Create message template with DLT parameters
                description: Create a message template with Distributed Ledger Technology (DLT) parameters required for sending SMS to India region
                value:
                  pinType: NUMERIC
                  messageText: Your pin is {{pin}}
                  pinLength: 4
                  language: en
                  voiceName: Joanna
                  senderId: Infobip 2FA
                  repeatDTMF: 1#
                  speechRate: 1.0
                  regional:
                    indiaDlt:
                      contentTemplateId: your-template-id
                      principalEntityId: your-entity-id
                      teleMarketerId: your-tele-marketer-id
          application/xml:
            schema:
              allOf:
              - $ref: '#/components/schemas/c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.CreateSmsOrVoiceMessageRequest'
            examples:
              Create message template:
                summary: Create message template
                value: "<?xml version=\"1.0\" encoding=\"UTF-8\"?><CreateSmsOrVoiceMessageRequest>\n  <pinType>NUMERIC</pinType>\n  <messageText>Your pin is {{pin}}</messageText>\n  <pinLength>4</pinLength>\n  <language>en</language>\n  <voiceName>Joanna</voiceName>\n  <senderId>Infobip 2FA</senderId>\n  <repeatDTMF>1#</repeatDTMF>\n  <speechRate>1.0</speechRate>\n</CreateSmsOrVoiceMessageRequest>\n"
              Create message template with placeholders:
                summary: Create message template with placeholders
                description: Create a message template with placeholders that can later be filled with different values for each PIN message
                value: "<?xml version=\"1.0\" encoding=\"UTF-8\"?><CreateSmsOrVoiceMessageRequest>\n  <pinType>NUMERIC</pinType>\n  <messageText>Hello {{firstName}} your pin is {{pin}}</messageText>\n  <pinLength>4</pinLength>\n  <language>en</language>\n  <voiceName>Joanna</voiceName>\n  <senderId>Infobip 2FA</senderId>\n  <repeatDTMF>1#</repeatDTMF>\n  <speechRate>1.0</speechRate>\n</CreateSmsOrVoiceMessageRequest>\n"
              Create message template with DLT parameters:
                summary: Create message template with DLT parameters
                description: Create a message template with Distributed Ledger Technology (DLT) parameters required for sending SMS to India region
                value: "<?xml version=\"1.0\" encoding=\"UTF-8\"?><CreateSmsOrVoiceMessageRequest>\n  <pinType>NUMERIC</pinType>\n  <messageText>Your pin is {{pin}}</messageText>\n  <pinLength>4</pinLength>\n  <language>en</language>\n  <voiceName>Joanna</voiceName>\n  <senderId>Infobip 2FA</senderId>\n  <repeatDTMF>1#</repeatDTMF>\n  <speechRate>1.0</speechRate>\n  <regional>\n    <indiaDlt>\n      <contentTemplateId>your-template-id</contentTemplateId>\n      <principalEntityId>your-entity-id</principalEntityId>\n      <teleMarketerId>your-tele-marketer-id</teleMarketerId>\n    </indiaDlt>\n  </regional>\n</CreateSmsOrVoiceMessageRequest>\n"
      responses:
        '200':
          description: successful response
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.SmsOrVoiceMessage'
              examples:
                Message template response:
                  summary: Message template response
                  value:
                    messageId: B628A31410306DDB2BFB0D9CF1F3A3FF
                    applicationId: 19F2491982980DBC2C40E1597FD175AB
                    pinPlaceholder: '{{pin}}'
                    messageText: Your pin is {{pin}}
                    pinLength: 4
                    pinType: ALPHANUMERIC
                    language: en
                    voiceName: Joanna
                    senderId: Infobip 2FA
                    repeatDTMF: 1#
                    speechRate: 1.0
            application/xml:
              schema:
                allOf:
                - $ref: '#/components/schemas/c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.SmsOrVoiceMessage'
              examples:
                Message template response:
                  summary: Message template response
                  value: "<?xml version=\"1.0\" encoding=\"UTF-8\"?><SmsOrVoiceMessage>\n  <messageId>B628A31410306DDB2BFB0D9CF

# --- truncated at 32 KB (1675 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/infobip/refs/heads/main/openapi/infobip-platform-api-openapi.yml