Custom Send OTP

If you prefer to generate the verification code yourself instead of having the EngageLab platform generate it, you can call this interface.

This interface is dedicated to sending pre-generated verification codes and will not generate verification codes by itself. After sending the verification code, there is no need to call the verification interface for verification.

If you prefer the EngageLab platform to generate the verification code, you can call the EngageLab OTP Send OTP interface.

Request URL

POST https://otp.api.engagelab.cc/v1/codes

Authentication

Please refer to Authentication to learn how to perform API authentication.

Request Example

Request Header

              
              POST /v1/codes  HTTP/1.1  
Content-Type: application/json  
Authorization: Basic amlndWFuZ2RldjpkZXZfc2VjcmV0

            

Request Body

              
              {
    "to": "+6591234567",
    "code":"398210",
    "template":{
      "id":"test-template-1",
      "language": "default",
        "params": {
        "key1": "value1",
        "key2": "value2"
        }
    }
}

            

Request Parameters

A request object is expressed in JSON format, so the request header must include Content-Type: application/json.

Notes on params

1. For fields preset in the template such as from_id, if the params field value is not passed, the preset from_id of the template will be used when the message is sent;
2. If a params field value is passed, such as params:{"from_id":"12345"}, the template's from_id will be replaced with 12345 when the message is sent;
3. At the same time, for custom variable fields in the template content when creating the template, they are also assigned values through params. For example, if the template content is Hi {{name}}, your verify code is {{code}}, you need to assign the parameter params:{"name":"Bob"}.
4. Email Channel Special Variables: For the Email channel, you can dynamically override the email subject (subject), sender name (from_name), sender email (from_mail), etc., through params. For detailed advanced usage, please refer to Create Template - Email Template Variables Advanced Usage.

Response Parameters

Success Response

              
              {
    "message_id": "1725407449772531712",
    "send_channel": "sms"
}

            

Note that the returned send_channel value does not represent the final channel delivered to the user, but only represents the channel used at this stage; for example, if the strategy configured in the template specifies that the WhatsApp channel fails to deliver and then automatically falls back to the SMS channel, the interface will return the whatsapp value. After sensing the delivery failure after a certain period of time, the system will use the SMS channel to send.

Failure Response

The HTTP status code is 4xx or 5xx, and the response body contains the following fields:

              
              {
    "code": 5001,
    "message": "sms send fail"
}

            

Error Codes