Applies for the practice's own UK mobile number with the business, address and representative given: the Messaging Service makes and submits the regulatory bundle for Twilio's review, and buys the number on approval. agreedToCosts must be true (the applicant agrees to the number's monthly price and to paying for the credits the practice buys). 400 with the fields when the details are refused; 409 billing_mandate_required without a Direct Debit; 409 unless the practice is awaiting a number, or while an application is already with the reviewer.
Requires: Admin on Messaging.
Parameters
| Name | Type | Description |
|---|---|---|
| tenant* | path string | The Tenant.Code |
The Tenant.Code |
||
Request Body*
{
"businessName": "string",
"registrationAuthority": "CompaniesHouse",
"registrationNumber": "string",
"website": "https://example.com",
"address": {
"street": "string",
"streetSecondary": "string",
"city": "string",
"region": "string",
"postalCode": "string",
"isoCountry": "string"
},
"representative": {
"firstName": "string",
"lastName": "string",
"email": "user@example.com",
"phoneNumber": "string"
}
}Responses
201 Created
400 Bad Request
401 Unauthorized – Invalid or missing API key
403 Forbidden – the caller lacks the permissions this endpoint requires; the detail lists every one missing
application/problem+json
409 Conflict
503 Service Unavailable