Register Number

Bring a phone number online for sending after you’ve verified it with Verification Code. The same endpoint also handles display-name changes — see Update Display Name.


POST /api/v25.0/{PHONE_NUMBER_ID}/register
Authorization: Bearer pk_live_<your-key>
Content-Type: application/json

Request body


{
  "messaging_product": "whatsapp",
  "pin":               "123456"
}

Field	Notes
`messaging_product`	Always `whatsapp`
`pin`	The 6-digit two-step-verification PIN registered against this phone number during onboarding
`new_verified_name`	Optional. Set this to also update the verified display name in the same call — see Update Display Name

Response — 200


{ "success": true }

After a successful register, the phone number’s status (see Phone Number Details) flips to CONNECTED and the number can send messages.

Errors

Body	When
`(#136025) Two-step verification pin mismatch`	Wrong `pin`. After 5 failed attempts the number is locked for 12 hours
`(#131045) Phone number not verified`	The number isn’t `VERIFIED` yet — re-run Verification Code first
`(#136100) Name change rate-limited`	If you sent `new_verified_name`, name changes are capped at one per 30 days

cURL — register


curl -X POST \
  "https://api.splashifypro.com/api/v25.0/$PHONE_NUMBER_ID/register" \
  -H "Authorization: Bearer $SPLASHIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "messaging_product": "whatsapp", "pin": "123456" }'

cURL — register and change display name in one call


curl -X POST \
  "https://api.splashifypro.com/api/v25.0/$PHONE_NUMBER_ID/register" \
  -H "Authorization: Bearer $SPLASHIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "pin":               "123456",
    "new_verified_name": "Splashify Pro"
  }'