Opt in Contact Flow
https://api2.protexting.com/v1/contacts-opt-in/createPass your server-side token as access_token. Replace sample values with your own. Authentication & setup →
Request parameters:
* required parameters
| Parameter | Description |
|---|---|
| * PhoneNumber | string, valid phone number, number must be in an international format, starting with the country code. Example: 164622233333 |
| * GroupIds | Array of group Ids |
We send an automatic opt-in CTA message to the recipient with the following text: Reply with YES to confirm your phone number Msg&Data rates may apply. This confirmation SMS can be changed in the account dashboard.
Once the mobile number is confirmed with YES, the system will send out a confirmation text message: Your phone number is successfully confirmed
HTTP Status Codes:
The standard HTTP Status Codes are used. More information is available here: http://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml
Example HTTP Status Code:
Status Code (response header) | Description (response header) | Field (response body) | Message (response body) |
|---|---|---|---|
| 422 | Data Validation Failed | The attribute that didn't pass the validation | The message, describing the validation error |
Example Request:
# Set PROTEXTING_ACCESS_TOKEN in your environmentcurl --request POST \ "https://api2.protexting.com/v1/contacts-opt-in/create?access_token=${PROTEXTING_ACCESS_TOKEN:?Set your API token}" \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "PhoneNumber": "16461234567", "GroupIds": [ 1 ]}'Example Response Headers:
Status Code: 201 Created
Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0
Connection: Keep-Alive
Content-Length: 243
Content-Type: application/json; charset=UTF-8
Keep-Alive: timeout=5, max=100
Pragma: no-cache
X-Powered-By: PHP/5.6.2
X-Rate-Limit-Limit: 60
X-Rate-Limit-Remaining: 59
X-Rate-Limit-ResetExample Response Body:
{
"message": "Confirmation message successfully sent",
}<response> <message>Confirmation message successfully sent</message></response>HTTP Status Codes:
The standard HTTP Status Codes are used. More information is available here: http://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml
Error Codes:
Error Codes and Examples here »
Reference from the ProTexting documentation catalog. Code examples are illustrative; this page does not execute API requests.