Purchase phone number
Initiate purchasing a WhatsApp phone number. Payment-first flow: the user does not pick a specific number. The system either creates a Stripe Checkout Session (first number) or increments the existing subscription quantity and provisions inline (subsequent numbers). Requires a paid plan. The maximum number of phone numbers is determined by the user's plan.
API key authentication - use your Late API key as a Bearer token
In: header
Profile to associate the number with
Response Body
application/json
application/json
curl -X POST "https://getlate.dev/api/v1/whatsapp/phone-numbers/purchase" \ -H "Content-Type: application/json" \ -d '{ "profileId": "507f1f77bcf86cd799439011" }'{
"message": "string",
"checkoutUrl": "http://example.com"
}{
"error": "Unauthorized"
}List phone numbers GET
List all WhatsApp phone numbers purchased by the authenticated user. By default, released numbers are excluded.
Release phone number DELETE
Release a purchased phone number. This will: 1. Disconnect any linked WhatsApp social account 2. Decrement the Stripe subscription quantity (or cancel if last number) 3. Release the number from Telnyx 4. Mark the number as released