API REFERENCEv1

Opt in Contact Flow

POSThttps://api2.protexting.com/v1/contacts-opt-in/create

Pass your server-side token as access_token. Replace sample values with your own. Authentication & setup →

Request parameters:

* required parameters

ParameterDescription
* 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:

Request example
# 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  ]}'
Server-side exampleJSON · HTTPS

Example Response Headers:

Response headers example
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-Reset

Example Response Body:

JSON response example
{
        "message": "Confirmation message successfully sent",
}
XML response example
<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.